iAdding documentation using manpages to the manifesto. - bitreich-documents - The repository to track the core bitreich documents. Err bitreich.org 70 hgit clone git://bitreich.org/bitreich-documents/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/bitreich-documents/ URL:git://bitreich.org/bitreich-documents/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/bitreich-documents/ bitreich.org 70 1Log /scm/bitreich-documents/log.gph bitreich.org 70 1Files /scm/bitreich-documents/files.gph bitreich.org 70 1Refs /scm/bitreich-documents/refs.gph bitreich.org 70 1Tags /scm/bitreich-documents/tag bitreich.org 70 i--- Err bitreich.org 70 1commit bfee9fcd36476cc540c704cb6421021f1e25277e /scm/bitreich-documents/commit/bfee9fcd36476cc540c704cb6421021f1e25277e.gph bitreich.org 70 1parent 56ab7788dc77adf357e2d2bfb0e097a688f62470 /scm/bitreich-documents/commit/56ab7788dc77adf357e2d2bfb0e097a688f62470.gph bitreich.org 70 hAuthor: Christoph Lohmann <20h@r-36.net> URL:mailto:20h@r-36.net bitreich.org 70 iDate: Tue, 30 Jan 2018 12:00:43 +0000 Err bitreich.org 70 i Err bitreich.org 70 iAdding documentation using manpages to the manifesto. Err bitreich.org 70 i Err bitreich.org 70 iThe addition of this paragraph was decided by the council on 2018-01-30. Err bitreich.org 70 i Err bitreich.org 70 iDiffstat: Err bitreich.org 70 i M bitreich-manifesto.md | 8 ++++++++ Err bitreich.org 70 i Err bitreich.org 70 i1 file changed, 8 insertions(+), 0 deletions(-) Err bitreich.org 70 i--- Err bitreich.org 70 1diff --git a/bitreich-manifesto.md b/bitreich-manifesto.md /scm/bitreich-documents/file/bitreich-manifesto.md.gph bitreich.org 70 i@@ -82,6 +82,14 @@ erything needs to be present. This is subject-oriented programming. Err bitreich.org 70 i Bugtrackers are obsolete. Whenever you find a bug, fix it. The other Err bitreich.org 70 i principles make it possible for you to send a patch instead of a report. Err bitreich.org 70 i Err bitreich.org 70 i+#### Straightforward Documentation Err bitreich.org 70 i+ Err bitreich.org 70 i+There are all kind of tools like javadoc, info etc. which fragment the Err bitreich.org 70 i+way to find useful information. All software should provide manpages. If Err bitreich.org 70 i+you need more features than manpages require, rethink what you are try‐ Err bitreich.org 70 i+ing to document. Manpages have a well‐defined structure which makes Err bitreich.org 70 i+finding and extracting the required information easier and uniform. Err bitreich.org 70 i+ Err bitreich.org 70 i #### Applications Can Be Done Err bitreich.org 70 i Err bitreich.org 70 i When a project solves a problem, keep it done and declare it so. New Err bitreich.org 70 .