Difference between revisions of "Documentation"

From Open Food Facts wiki
Jump to navigation Jump to search
Line 8: Line 8:
 
|+ Documentation of OFF codebases and APIs
 
|+ Documentation of OFF codebases and APIs
 
|-
 
|-
! Product !! Doc !! Doc
+
! Product !! Doc !! Comment
 
|-
 
|-
| Server code || Example || Example
+
| Server code || [https://openfoodfacts.github.io/openfoodfacts-server/ Code doc] || Example
 
|-
 
|-
| API || Example || [https://github.com/openfoodfacts/api-documentation Doc repo]
+
| API || [https://github.com/openfoodfacts/api-documentation API doc] || Example
 
|-
 
|-
 
| Android || [https://openfoodfacts.github.io/openfoodfacts-androidapp/ Code doc] || Example
 
| Android || [https://openfoodfacts.github.io/openfoodfacts-androidapp/ Code doc] || Example
 
|-
 
|-
| iPhone || Example || Example
+
| Flutter || [https://openfoodfacts.github.io/smooth-app// Code doc] || Example
|-
 
| Flutter || Example || Example
 
 
|-
 
|-
 
| Dart package || [https://openfoodfacts.github.io/openfoodfacts-dart/ Code Doc] || Example
 
| Dart package || [https://openfoodfacts.github.io/openfoodfacts-dart/ Code Doc] || Example
 
|-
 
|-
| Example || Example || Example
+
| iPhone || Example || Example
|-
 
| Example || Example || Example
 
|-
 
| Example || Example || Example
 
|-
 
| Example || Example || Example
 
 
|}
 
|}
 +
 
=== 2021 Documentation roadmap ===
 
=== 2021 Documentation roadmap ===
  

Revision as of 15:36, 31 August 2021

Documentation

Documentation of OFF codebases and APIs
Product Doc Comment
Server code Code doc Example
API API doc Example
Android Code doc Example
Flutter Code doc Example
Dart package Code Doc Example
iPhone Example Example

2021 Documentation roadmap

Project tracking on GitHub

  • Set up a bi-monthly call for documentation

Set up a process to make publication a breeze

  • Publish the new documentation to our new servers
  • Automate the publication of the documentation
  • Deprecate the old wiki doc

Set up a process to keep documentation fresh

  • Keep the documentation on par with the API
  • Generate new separate, fast-moving documentation from the questions in #api or #general, and consider integrating some of it in the main documentation

Improve the documentation

  • Document assumptions and things we (d/w)on't do