Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • TODO: search for an expert in tooling / doc writing that can support
  • TODO: support from LF?
  • TODO: evaluate tooling and best-practice process for open source documentation and increase acceptance of developers
  • TODO: reactivate / update doc team liaisons (as we had it in earlier times)?
  • PROPOSAL: Complete restart with the above discussed QA processes in place to build up a new documentation and using only validated / approved and therefore valid content. Even if we are expecting, that the upcoming doc releases will be incomplete or empty in large areas in the beginning.

Questions

...

(question) What is the value of more and more ONAP features without having them - and other, important basics - not well documented?

Example: SDC usage

...

(question) Are we (developers, PTL, members of the doc project, TSC, ...) able to master the current challenges for ONAP doc without spending much (!) more time and effort for documentation?

...


(question) Are we willing to spend much (!) more time and effort for documentation?

...


(question) How can "we" incentivize "good" documentation?

...

Document History

2019-12-10 Initial doc based on the (modified) mindmap. Alignment to be done.

...