3
1
Fork
You've already forked website
0

Refer to https://doc.guix.gnu.org for the manual #4

Merged
civodul merged 1 commit from civodul/doc.guix.gnu.org into master 2026年05月17日 11:59:12 +02:00 AGit

This is a proposal to refer to https://doc.guix.gnu.org for the manual.

The expected benefits are: easier release process (no need to fiddle with gendocs.sh, CVS, etc.), better rendering (including syntax highlighting and cross-references on identifiers in code snippets), more consistent cross-references, better navigation, and eventually more features (side navigation panel, keyword search).

Potential downside: small delay between release and publication of the manual (by default only releases packaged in Guix appear).

Thoughts?

This is a proposal to refer to https://doc.guix.gnu.org for the manual.<br><br>The expected benefits are: easier release process (no need to fiddle with `gendocs.sh`, CVS, etc.), better rendering (including syntax highlighting and cross-references on identifiers in code snippets), more consistent cross-references, better navigation, and eventually more features (side navigation panel, keyword search).<br><br>Potential downside: small delay between release and publication of the manual (by default only releases packaged in Guix appear).<br><br>Thoughts?
* website/apps/base/index-page.scm (manual-ref): Change URL to
doc.guix.gnu.org.
* website/apps/base/learn-page.scm (learn-page): Likewise.
Author
Owner
Copy link

Ping @old, @rlb.

Ping @old, @rlb.
First-time contributor
Copy link

I like it.

I like it.
Author
Owner
Copy link

I went ahead and pushed this.

I also added redirects (.htaccess files in the CVS repo) for manual URLs such as:

I went ahead and pushed this. I also added redirects (`.htaccess` files in the CVS repo) for manual URLs such as: - https://www.gnu.org/software/guile/manual/html_node/Processes.html (3.0) - https://www.gnu.org/software/guile/docs/docs-2.2/guile-ref/Programming-in-Scheme.html (2.2) - https://www.gnu.org/software/guile/docs/docs-2.0/guile-ref/Programming-in-Scheme.html (2.0)
Owner
Copy link

(Also seemed fine to me. Thanks.)

(Also seemed fine to me. Thanks.)
Sign in to join this conversation.
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
3 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
guile/website!4
Reference in a new issue
guile/website
No description provided.
Delete branch "civodul/doc.guix.gnu.org"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?