Features/Sugar3 Docs: Difference between revisions

No edit summary
 
(4 intermediate revisions by 2 users not shown)
Line 11: Line 11:
* Targeted release: 0.108
* Targeted release: 0.108
* Last updated: 8/Aug
* Last updated: 8/Aug
* Percentage of completion: 10%
* Percentage of completion: 10% (see [https://developer.sugarlabs.org/sugar3/ documentation website])


== Detailed Description ==
== Detailed Description ==
Line 20: Line 20:
=== Example Docstring ===
=== Example Docstring ===


Let's just use google style doc strings, they are very clean and simmilar to the current style.  [http://sphinx-doc.org/ext/example_google.html#example-google Longer example.]
Let's just use google style doc strings, they are very clean and similar to the current style.  [http://sphinx-doc.org/ext/example_google.html#example-google Longer example.]


  <nowiki>
  <nowiki>
Line 74: Line 74:
         Args:
         Args:
             happy (bool): a description for happy
             happy (bool): a description for happy
             lol (bool, optional): a optional argument, explain what
 
        Keyword Arguments:
             lol (bool): a optional argument, explain what
                 it defaults to
                 it defaults to


Line 106: Line 108:


== Release Notes ==
== Release Notes ==
The Sugar toolkit now has imporved API documentation coverageView our docs here: dev.sam.today (real url when it is done of course)
The Sugar Toolkit has improved API documentation.  See https://developer.sugarlabs.org/sugar3/


== Comments and Discussion ==
== Comments and Discussion ==