# Singular Docs

**URL:** https://ps.zoethical.org/t/singular-docs/8350
**Category:** Documentation
**Tags:** about, doc-index
**Created:** [October 10, 2024, 2:21am UTC](https://ps.zoethical.org/t/singular-docs/8350 "2024-10-10T02:21:40Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![how](https://ps.zoethical.org/user_avatar/ps.zoethical.org/how/32/2236_2.png) [@how](https://ps.zoethical.org/u/how)
#### Post date: [October 10, 2024, 2:21am UTC](https://ps.zoethical.org/t/singular-docs/8350/1 "2024-10-10T02:21:40Z")

</div>

Sharing structured knowledge from _petites singularités_.

 

## Purpose

This conference is to provide public documentation using the experimental [discourse-doc-categories plugin](https://meta.discourse.org/t/discourse-doc-categories/322376), replacing the legacy `/docs`.

## Scope

The #docs presented here aims to provide :ps: members with our methodologies and approaches, as well as other forms of help we deem useful to ourselves and maybe others, in the struggle to awaken territories to life.

## Structure

### Indices

All documentation index topics are tagged with #doc-index.

Staff can [review non-indexed topics](https://ps.zoethical.org/admin/reports/doc_categories_missing_topics?filters=%7B%22include_topic_from_subcategories%22%3Atrue%7D&mode=table) (that should be indexed since they’re supposed to be documentation) and [review extraneous topics](https://ps.zoethical.org/admin/reports/doc_categories_extraneous_items?filters=%7B%22include_topic_from_subcategories%22%3Atrue%7D&mode=table) (that look like they do not belong in docs).

### Documentation tags

> [@The Documentation tag group](https://ps.zoethical.org/t/the-documentation-tag-group/7243/1):
>
> When tagging a documentation topic, you can add an extra tag (only one) among:
> 
> 1. #tutorial for learning-oriented material (practical / studying)
> 2. #howto for problem-oriented material (practical / working)
> 3. #explanation for understanding-oriented material (theoretical / studying)
> 4. #reference for information-oriented material (theoretical / working)
> 
> Additionally, we have a #faq tag for transversal dispatch to relevant topics via frequently asked/answered questions.

# Documented Topics

## Tutorials (#tutorial)

_Learning-oriented documentation providing practical steps, most useful when studying._

**Computers & Internet**

- [How to setup a website from scratch](https://ps.zoethical.org/t/how-to-setup-a-website-from-scratch/376) in 30 minutes

**Food & Beverages**

- [Un guide pratique pour la fabrication d’une boisson énergétique à partir de renouée du Japon](https://ps.zoethical.org/t/un-guide-pratique-pour-la-fabrication-d-une-boisson-energetique-a-partir-de-renouee-du-japon/6974)
- [A Practical Guide to Making an Energy Drink from Japanese Knotweed](https://ps.zoethical.org/t/a-practical-guide-to-making-an-energy-drink-from-japanese-knotweed/6973)

## How-to Guides (#howto)

_Problem-oriented documentation providing practical steps, most useful when working._

- [Install Ruby](https://ps.zoethical.org/t/install-ruby/7242) on Debian
- [Nullmailer setup](https://ps.zoethical.org/t/nullmailer-setup/8727)
- [Comment rejoindre les petites singularités?](https://ps.zoethical.org/t/comment-rejoindre-les-petites-singularites/3952)
- [https://ps.zoethical.org/t/unattended-upgrades-setup/5717](https://ps.zoethical.org/t/unattended-upgrades-setup/5717)

## Explanations (#explanation)

_Understanding-oriented documentation providing theoretical knowledge, most useful when studying._

## Reference (#reference)

_Information-oriented documentation conveying theoretical knowledge, most useful when working._

* * *

> **Original instructions**
>
> (Replace this first paragraph with a brief description of your new category. This guidance will appear in the category selection area, so try to keep it below 200 characters.)
> 
> Use the following paragraphs for a longer description, or to establish category guidelines or rules:
> 
> - Why should people use this category? What is it for?
> 
> - How exactly is this different than the other categories we already have?
> 
> - What should topics in this category generally contain?
> 
> - Do we need this category? Can we merge with another category, or subcategory?