Docs on conditional content

[agjohnson]

A common question we get is how to do conditional content with Sphinx. There are a few options for this:

• https://www.sphinx-doc.org/en/master/usage/extensions/ifconfig.html#module-sphinx.ext.ifconfig
• https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#directive-only

We should document these two methods in a guide or perhaps even break out an author's guide to start some RTD independent content on Sphinx authoring.

[agarwalrounak]

Hi @agjohnson ! I think the issue #4603 deals with the same thing.
#4603 (comment)

[agarwalrounak]

I have asked to work on that issue and I can include one more description under "How to have conditional content in your documentation" :

• Using ifconfig directive to make conditional content

[stsewd]

I think the issue #4603 deals with the same thing.

@agarwalrounak yes, they are related. Probably they can be addressed in the same PR

[agarwalrounak]

@stsewd Sure, I will send a PR soon.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[dojutsu-user]

Still valid bot.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[humitos]

I'm closing this one in favor of #4603

[stsewd]

We should update the other issue to include the other methods that are mentioned here