-
Notifications
You must be signed in to change notification settings - Fork 73
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
Update templates.md #341
Update templates.md #341
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is a decent first draft of a comprehensive survey of metaprogramming topics in D. Unfortunately, that makes it a poor fit for the D tour, which wants short, focused, introductory articles on individual topics.
If you would like to submit any of this content for inclusion in the D tour, please split it into individual pages, each no more than 200 lines in length and focused on a single language feature or programming technique. Some of the material (for example, the part on CTFE) could also be submitted as improvements to existing tour pages.
Thanks a lot for helping out! I don't have time atm to review in-depth, but a first comment: is there a possibility to split this into two or three sections? |
Okay. I will rework it and split it into a few sections.
…On Thu, 3 Sep 2020 at 19:38 Sebastian Wilzbach ***@***.***> wrote:
Thanks a lot for helping out! I don't have time atm to review in-depth,
but a first comment: is there a possibility to split this into two or three
sections?
At the moment most sections of the tour are roughly one page, so that the
user isn't over-whelmed with content.
—
You are receiving this because you authored the thread.
Reply to this email directly, view it on GitHub
<#341 (comment)>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/ADDSQ45PSOJM2UDMBTBBVXDSD7PBFANCNFSM4QU27IGQ>
.
|
I shall rework this and split it into a few sections. |
@dataPulverizer I think that the following file structure would be the organization that best fits the tour:
|
I'm happy to do this but I created a separate PR #342 after cancelling this one. Shall I delete the new PR? I'm happy to do so if it is clearer. I created it because for some reason I didn't realise I could re-submit a different document structure in this PR. From the above comments before yours, I thought people wanted something smaller and more brief, both for each document and for the overall length, which is why the new PR contains a small fraction of my initial PR split over different documents. Shall I reopen and work within this PR so the history is retained? If so I can put the original material into the structure you have specified and do another PR. Please confirm. Thanks. |
I have replaced the current templates tour with a highly detailed tutorial on generic and metaprogramming in D.
Thanks