Documentation | Draft: tag: Use only and tags to make conditional text (!163)

Amar Takhar (@amar) gitlab at rtems.org
Mon Mar 17 23:29:36 UTC 2025




Amar Takhar commented on a discussion: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/163#note_121164


@chris said the same thing but as I stated above: the default build shows everything The example image above shows what it looks like so there is no difference.

If you search on google the first hit for docs is the devel docs.  Plenty of projects handle it using watermarks or other notices to let users know they are on development docs but our problem is we are letting search engines index URLs that will never work.  They only work for the released versions that's a different problem.

There is no overhead here to worry about as the overhead is during deploying the development docs with the default having the warning and a released version no warning.  Sphinx has this support for this very reason.

In any case I'm switching from using tags to `ifconfig` as it's better suited.

-- 
View it on GitLab: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/163#note_121164
You're receiving this email because of your account on gitlab.rtems.org.


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/bugs/attachments/20250317/ff4b1f0a/attachment.htm>


More information about the bugs mailing list