Remove "Read the docs" (static site generator) #4523

Closed
opened 2025-11-26 21:04:17 -06:00 by GiteaMirror · 2 comments
Owner

Originally created by @nodiscc on GitHub (May 14, 2022).

Followup to https://github.com/awesome-selfhosted/awesome-selfhosted/pull/2900

Read the docs in https://github.com/awesome-selfhosted/awesome-selfhosted#software-development---documentation-generators is a static site generator. Although it is very good (uses Sphinx) awesome-selfhosted does not list static site generators.

It should be removed.

Originally created by @nodiscc on GitHub (May 14, 2022). Followup to https://github.com/awesome-selfhosted/awesome-selfhosted/pull/2900 `Read the docs` in https://github.com/awesome-selfhosted/awesome-selfhosted#software-development---documentation-generators is a static site generator. Although it is very good (uses [Sphinx](https://www.sphinx-doc.org/)) awesome-selfhosted does not list [static site generators](https://github.com/awesome-selfhosted/awesome-selfhosted#static-site-generators). It should be removed.
GiteaMirror added the fixcurationhelp wanted labels 2025-11-26 21:04:17 -06:00
Author
Owner

@mzch commented on GitHub (May 23, 2022):

Indeed Read The Docs is a static document generator, but itself is a self-hostable web app. Why is it neccesary to remove?

@mzch commented on GitHub (May 23, 2022): Indeed `Read The Docs` is a static document generator, but itself is a self-hostable web app. Why is it neccesary to remove?
Author
Owner

@nodiscc commented on GitHub (May 31, 2022):

A static site generator is a software application that creates HTML pages from templates or components and a given content source. The resulting static pages can be served from any web server. The process of generating pages is separate from hosting the content, and does not necessarily (and often doesn't) happen on the server (usually static sites are built beforehand on a build/developer machine, then uploaded to the web server).

Anyway staticsitegenerators.net and staticgen.com are excellent resources, are very well maintained and anyone collaborate to these lists through their already established processes. So there is not point at all in duplicating the effort.

Issue fixed in https://github.com/awesome-selfhosted/awesome-selfhosted/pull/3022

@nodiscc commented on GitHub (May 31, 2022): A static site generator is a software application that creates HTML pages from templates or components and a given content source. The resulting static pages can be served from any web server. The process of generating pages is separate from hosting the content, and does not necessarily (and often doesn't) happen on the server (usually static sites are built beforehand on a build/developer machine, then uploaded to the web server). Anyway [staticsitegenerators.net](https://staticsitegenerators.net/) and [staticgen.com](https://www.staticgen.com/) are excellent resources, are very well maintained and anyone collaborate to these lists through their already established processes. So there is not point at all in duplicating the effort. Issue fixed in https://github.com/awesome-selfhosted/awesome-selfhosted/pull/3022
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/awesome-selfhosted#4523