Share docs

[qinohe]

Hello, I have build a clean container setup for building the docs, cloned the repo and did build the docs, uploaded the result to a local web server and tested it.
Very nice, I never worked with Sphinx nor ReadTheDocs before but I may just convert my own local wiki to it, works beautiful.
Now if I understand I can just throw my .rst in the right dir. with the imgages appended & in the right dir. and it will build right? That would be very very easy. 
Also, forgive my noob ness here, but I have question about git I don't use it much: I fork the repo to my own github account than do the adjustments push them back to my account.
You guys would be notified when I pushed the change to my own account, right...

Thanks mark

edit: just added my own page, nice, though that page is not ready but this super easy, I like it

[franco]

Hi mark,

When you push your changes to your local GitHub account you can then open "pull requests" to the main repository. One pull request per branch per feature or bug or correction you want to make. It heavily depends on your preferred work flow and the scope of work.

For docs I'd say if you have smaller typos and wording you can batch them, but if you add new pages it makes sense to only add those and avoid touching other pages.


Thanks,
Franco

[qinohe]

Hey franco, I understand your concerns and will add new page/s separate to edit's done on other pages.
Hehe, I have my hands full on this for now. I get the hang of the markup so await this first in a little while.

Well I will read myself into git a little I understand the basics so that will work out well with your tips 

Greetings mark

[franco]

git can be hell. If you have questions let us know.


Cheers,
Franco

[qinohe]

Thanks, I have just forked the docs that went well, the rest will soon be history
If something isn't working I will bug you again 

Greets mark

[qinohe]

Good day, I'm already making fair progress on the page I'm creating, had to do a quick course on Sphinx & a refresh of HTML+CSS.
Think it's at least ten years back 
Now while editing the page I found there are some things not there like use of text color, is this a design decision?
If not, can I add a custom 'color' CSS to the project and add it to conf.py or is that not allowed?
I have already set it up local, works fine. 

Thanks mark