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

Documentation of foreign package configuration options #15

Open
@GHNewbiee

Description

@GHNewbiee

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions