Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation Project:) #7

Open
prepare opened this issue Jan 23, 2017 · 14 comments
Open

Documentation Project:) #7

prepare opened this issue Jan 23, 2017 · 14 comments

Comments

@prepare
Copy link
Member

prepare commented Jan 23, 2017

First I'm not a native English speaking person.
so you can correct it where it is wrong grammar/ wrong intention or not proper.

You CAN HELP ME create the topics that you want to know.
so I will create a description for it

:)

@ArsenShnurkov
Copy link
Contributor

ArsenShnurkov commented Jan 21, 2019

  1. Please create gh-pages branch in this repository
    ( https://help.github.com/articles/configuring-a-publishing-source-for-github-pages/ )
  2. Please add intro page to that branch, and deploy it to CDN
  3. Please edit URL field in project main page to point to that site on CDN
    (for example please look at this project - https://github.com/klange/ponyos , it have a link to it's "homepage" right next to the project's description, between "< > Code" tab and hashtags.)
  4. Please provide instructions on how to join to development discussion (mailing list, xmpp conference name, or something)

@prepare
Copy link
Member Author

prepare commented Jan 22, 2019

@ArsenShnurkov
Copy link
Contributor

ArsenShnurkov commented Jan 22, 2019

url field from point 3 was not added, so one can navigate from site to github, but can't navigate in opposite direction.
6. i don't see "gh-pages" branch in the repository linked from that site, so I don't understand, how to contribute content to it via PRs

@ArsenShnurkov
Copy link
Contributor

My remaining questions about this project are:

  • how to change the website of project, what is the process for this
  • what are the dependencies of the project (for quick check what I need to build and package first)
  • what is the testing process (which framework is used, how to create a new unit test). This is optional, only thing i need to understood - it's how to remove all testing from the solution, because NUnit is not packaged in gentoo yet (it requires Cake, Cake requires not packaged parts msbuild and so on - too much work).

@prepare
Copy link
Member Author

prepare commented Jan 22, 2019

How to change the website of project, what is the process for this?

=> the current project's website is auto-generated page from GitHub's tool.
It was generated from readme.md

What are the dependencies of the project?

=> It needs PixelFarm and Typography see detail in PaintLab/PixelFarm#37

What is the testing process?

=> I tested it with some examples in test/example folder.
No systematic test now :(

@prepare
Copy link
Member Author

prepare commented Jan 22, 2019

Contributor guideline => see Notes on my intentions

@ArsenShnurkov
Copy link
Contributor

So, what if I want to add instructions about building this thing under portage? I need to edit readme file and provide pictures. If there were a separate branch, I think the separate branch would be more convenient than editing the readme file.

About dependencies, i was asked about other dependencies, not only between parts of project. I remember that somewhere was dependencies even from GDI+.

@prepare
Copy link
Member Author

prepare commented Jan 23, 2019

  1. I invite you here => https://paintlab.github.io/pxdev/
    ( 1.1 since it should be a start point for building the HtmlRenderer,
    1.2 it is a lightwight repo for building and documentation.
    1.3 after it is settle I will bring the content to here)

  2. I will recheck the dependencies again esp native dll(s)

@prepare
Copy link
Member Author

prepare commented Jan 23, 2019

I invite you as a collaborator of https://github.com/PaintLab/pxdev
check your e-mail for an invitation.
Free free to write and edit the repo.

@ArsenShnurkov
Copy link
Contributor

ArsenShnurkov commented Jan 23, 2019

I am looking at some unrelated project website (https://www.npgsql.org/doc/), and see the label "gitter:join chat" - gitter.
What do you think about using that site (gitter.im) for communications? Which channel to join?

when I am trying to join https://gitter.im/PaintLab/pxdev it says me:
"If you're looking to access a private repository, you will need to upgrade your GitHub authentication to allow us to access the list of your private repositories."
and when I update github's authentification, gitter.im says "404. This is not the chat you're looking for. Sorry. :(" meaning that there is no such chat (that happens after accepting the invitation)

@prepare
Copy link
Member Author

prepare commented Jan 24, 2019

I click your link now https://gitter.im/PaintLab/pxdev , it says the same

  1. This is not the chat you're looking for. Sorry. :(

I'm not ready for any real-time chat because
I can't read that chat and/or see notification all the time.
=> other users still need to wait for reply at the rate I reply
the GitHub issues/notification.

@ArsenShnurkov
Copy link
Contributor

chat have difference with issues it that aspect that anyone feel easier to ask questions, which are not issues by itself. Actually we are chatting here in issues, and (in my feeling) this is not what the issues are destined for.

Even if you will answer rarely, it will allow to other users to ask questions. It's nothing wrong to not answer immediately. That chat keeps the history, and notify via email about new messages if you want.

The chat is the road for users of community to interoperate between themselves.
I think that you need to create that chat on the gitter.im site.

@prepare
Copy link
Member Author

prepare commented Jan 24, 2019

OK,
Lets create a chat room.

@prepare
Copy link
Member Author

prepare commented Jan 24, 2019

Try this ...
https://gitter.im/paintlab_pxdev/community?utm_source=share-link&utm_medium=link&utm_campaign=share-link

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants