Changes

Jump to navigation Jump to search
Line 101: Line 101:  
===Risks===
 
===Risks===
 
* '''Risk [[#1]]: your beginner guide does not help a beginner'''
 
* '''Risk [[#1]]: your beginner guide does not help a beginner'''
::* Currently Sugar Labs has multiple newcomer guides in the forms of a book, [https://wiki.sugarlabs.org/go/Documentation_Team Sugar Wiki], and [https://github.com/sugarlabs/sugar-docs sugardoc], [https://wiki.sugarlabs.org/go/Google_Code_In_2017/background GCI Starter]. I will try to recompile them and bring all the resources at a single place with proper inter-linking, It’ll facilitate proper navigation.
+
::* Currently Sugar Labs has multiple newcomer guides in the forms of a book, [https://wiki.sugarlabs.org/go/Documentation_Team Sugar Wiki], and [https://github.com/sugarlabs/sugar-docs sugardoc], [https://wiki.sugarlabs.org/go/Google_Code_In_2017/background GCI Starter].
::* Now instead of having multiple newcomer guide resources, we can add all the resources in one place.
+
::* I will try to bring the content of all these resources at a single place which would be sugardoc because we would be utilizing [http://www.sphinx-doc.org/en/master/ sphinx] to convert markdown to HTML, pdf format. We have another alternative to display content on our dashboard using [http://docs.readthedocs.io/en/latest/embed.html ReadtheDoc Embed] feature.
 +
::* Now instead of having multiple newcomer guide resources, we can add all the resources in one place and remove other resources of newcomer guide.
 
::* I have large student community at my college. I have a thought of organizing Sugar Labs online seminar, where we can guide them about Open Source contribution, and direct them to the newcomer guide.
 
::* I have large student community at my college. I have a thought of organizing Sugar Labs online seminar, where we can guide them about Open Source contribution, and direct them to the newcomer guide.
::* So, it will provide me raw feedback from them and I can improve the guide further, in case many students are facing the same problem.  
+
::* I could take their feedback and improve the guide further. In case many students are facing the same problem, I’ll try to find the reason and resolve it.
::* It will also increase the number of contributors to sugarlabs.
+
::* After intensive testing during the tenure from that stater category of the developer, it will help the other new developers in an easy manner.
 +
::* Further as the only markdown will be used as new-comer guide, other resources have been removed, so the community doesn't need to devote there work at different places instead they need to work on one place, and markdown is easily accessible by everyone.
    
* '''Risk [[#2]]; Beginner guide conflicts with other information'''
 
* '''Risk [[#2]]; Beginner guide conflicts with other information'''
90

edits

Navigation menu