90
edits
Changes
Summer of Code/2018/Making a Beginner Guide (view source)
Revision as of 13:15, 16 March 2018
, 13:15, 16 March 2018→Counterpart the Risks
====Sugarbot====
====Sugarbot====
===Counterpart the Risks===
===Counterpart the Risks===
* '''Risk [[#1]]: your beginner guide does not help a beginner'''
::* Currently Sugar Labs has multiple newcomers guides in the forms of a book, [https://wiki.sugarlabs.org/go/Documentation_Team Sugar Wiki], and [https://github.com/sugarlabs/sugar-docs sugardoc], I will try to recompile them and bring all the resource at a single place with proper inter-linking, It’ll facilitate proper navigation.
::* Now instead of having multiple newcomer guides resources, we can add all the resources in one place.
::* 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 that guide further, in case many students are facing the same problem also it will increase more number of the contributors to sugarlabs.
* '''Risk [[#2]]; Beginner guide conflicts with other information'''
::* Those formats will be used which are generally acceptable and maintained by everyone.
::* Basic Html 5 tags and CSS attributes will be utilized.
::* Throughout the development only open-source software and technologies like [https://github.com/twbs Bootstrap], [https://github.com/angular Angular], [https://github.com/nodejs NodeJs], [https://github.com/angular/material2 Material] etc will be used.
::* To convert Html files to markdown https://domchristie.github.io/turndown/
::* The open Source software https://wkhtmltopdf.org/ will be used to convert the completed website in a good layout pdf.
::* Remove information from the current existing guide and put the link to new guide at those places and linked properly for proper navigation.
===Project and the community===
===Project and the community===