Skip to content
This repository has been archived by the owner on Jun 11, 2023. It is now read-only.

Documentation of foreign package configuration options #15

Open
GHNewbiee opened this issue Aug 5, 2020 · 0 comments
Open

Documentation of foreign package configuration options #15

GHNewbiee opened this issue Aug 5, 2020 · 0 comments
Labels
documentation Improvements or additions to documentation

Comments

@GHNewbiee
Copy link

GHNewbiee commented Aug 5, 2020

When you use foreign packages and want to mention their configuration options, you could also use an extra table to make clearer what options are actually available to the user. A reader/user instantly gets a very good and complete idea. An example/template is given right below:

<package> options

Last updated: xx xxx xx

Option default Reboost (1) User (2) Remark (3)
... ... ... YES About option...; See link (to documentation); etc
INACTIVATED Avoid Causes side effect(s); Under investigation; Not yet investigated; Unknown behaviour; etc
REMOVED Never Breaks Reboost functionality; Fatal error; etc
May It's uninteresting; etc

(1) The value (same as default or altered) that Reboost has chosen. Reboost may also decide for some reason to inactivate or remove an option. Columns Reboost and User are not related to each other in the above example.

(2) If user is allowed to alter the value set by Reboost.

(3) Columns User and Remark are fully related to each other in the above example.

@sarsamurmu sarsamurmu added the documentation Improvements or additions to documentation label Aug 7, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

2 participants