Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

document view generation #3

Open
shriram opened this issue Apr 19, 2023 · 0 comments
Open

document view generation #3

shriram opened this issue Apr 19, 2023 · 0 comments

Comments

@shriram
Copy link

shriram commented Apr 19, 2023

An interesting use case in Bootstrap is that we want to write one file that contains multiple overlapping documents: e.g., the file contains both a student view and teacher view (such as pedagogy notes). There is benefit to authoring these all in one place (which is especially important for keeping it up-to-date). But then it needs to be split—using some kind of directive—into multiple documents. (The provision and use of these directives is itself a small challenge that, e.g., Markdown can't handle.)

N.B.: One can think of this as a kind of #ifdef.

Dorai can provide a very concrete example of this from the Bootstrap documentation. (In general, studying the Bootstrap documentation build docs w/ Dorai could be very valuable, because there are many complex scenarios in there, though I'm not sure how many kinds of scenarios there are—that analysis would itself be enlightening.)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant