On 11/13/21 7:31 AM, Tobias Killer wrote:
Am 27.09.21 um 13:46 schrieb Andrew David Wong:
Hello,
This discussion here contains a lot of Pros and Cons but no decision. Is
there already a silent decision towards "no"?
Nope.
At least, I cannot see any action towards "yes".
I just haven't
Am 27.09.21 um 13:46 schrieb Andrew David Wong:
## Summary
Currently, the Qubes documentation is written in plain text Markdown
files, version controlled with Git, rendered using Jekyll, and hosted
from GitHub Pages. This setup has served us well over the years, but as
the demands on the
The following is more a question of my own curiosity.
Is it possible that the existing documentation setup can be put into one or
more qubes_template(s) so that it is already pre-configured?
On Mon, Oct 4, 2021 at 3:16 PM 'awokd' via qubes-devel <
qubes-devel@googlegroups.com> wrote:
> Andrew
Andrew David Wong:
We've had the current setup for a long time. Why should we consider
migrating now? We've considered it in the past and decided against it at
the time, so what's changed? The answer is that there are new and
increasing demands on the documentation, the main two being
Am 28.09.21 um 20:25 schrieb Marek Marczykowski-Górecki:
On Tue, Sep 28, 2021 at 06:06:41PM +, Tobias Killer wrote:
Hello,
one feature that is often used in Qubes Doc is the automatic generation of
HTML IDs like, for example, if the source Markdown file contains
```
# Hello world
```
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA256
On Tue, Sep 28, 2021 at 06:06:41PM +, Tobias Killer wrote:
> Hello,
>
> one feature that is often used in Qubes Doc is the automatic generation of
> HTML IDs like, for example, if the source Markdown file contains
>
> ```
> # Hello world
> ```
Hello,
one feature that is often used in Qubes Doc is the automatic generation
of HTML IDs like, for example, if the source Markdown file contains
```
# Hello world
```
the resulting HTML file contains
```
Hello world
```
which means one can link to that heading via `[Link](#hello-world)`.
So, what do you all think?
The goal should be that a lot more of the available attention and energy can flow towards
the actual content, rather than maintaining "the system".
RTD vs. Wiki
Wiki's are ubiquitous and very easy to edit. But that could end up being a
problem, as Konstantin