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

Create a Table of Contents for README.md #225

Open
ConsenSys-Academy opened this issue Mar 9, 2022 · 9 comments
Open

Create a Table of Contents for README.md #225

ConsenSys-Academy opened this issue Mar 9, 2022 · 9 comments
Labels

Comments

@ConsenSys-Academy
Copy link
Collaborator

To allow people to easily browse and acquaint themselves with the technical content, it would be helpful to have a Table of Contents on the README.md page. This Table of Contents should shows the overall structure of the course, with the modules and lessons linked.

Since the overall nested structure is really large, for readability, it might be helpful to use something like the <details> and <summary> html features when building this Table of Contents. More on those html features here.

@ConsenSys-Academy ConsenSys-Academy added the good first issue Good for newcomers label Mar 9, 2022
@matthewbub
Copy link

to confirm my understanding , we'd want something like:

Table of contents

S00-intro

@matthewbub
Copy link

@ConsenSys-Academy Is there a preference on relative vs absolute pathing for the links?

@ConsenSys-Academy
Copy link
Collaborator Author

@yeahmat Hey there! That's exactly right, the only note I'd have would be to use the title of the section / module / lesson as the link text. So (S00-intro)[link here] would be something like (Introduction to the Course)[docs/S00-intro]. Does that make sense? I can help with this if needed.

No preference on relative vs absolute pathing for the repo, I don't think.

Some sections are also missing content (their available as a video on the LMS that we'll need to migrate over), it might be good to note that with an asterisk, if possible.

Once you start working on this, though, we can collab!

@matthewbub
Copy link

So (S00-intro)[link here] would be something like (Introduction to the Course)[docs/S00-intro]. Does that make sense?

Absolutely, grab the H1 text from the actual document, and not the document name itself. 👍

No preference on relative vs absolute pathing for the repo, I don't think.

I think relative would be easier manage in the long term. I'll go relative unless there are objections 🙂

Some sections are also missing content (their available as a video on the LMS that we'll need to migrate over), it might be good to note that with an asterisk, if possible.

Confirmed, if no content exists in the Markdown file for the section, leave an asterisk.


I'll get started a bit later this afternoon. Mostly copy/pasting so it should be able to have it in a review state by 05/13

@ConsenSys-Academy
Copy link
Collaborator Author

@yeahmat awesome! let me know if you have any more questions. Sometimes we miss pings on here so feel to ping in the Edu-DAO discord as well!

@ConsenSys-Academy
Copy link
Collaborator Author

@yeahhhmat Wanted to check in ... Any progress on this?

@ConsenSys-Academy
Copy link
Collaborator Author

@yeahhhmat One more ping!

@lonasozo
Copy link
Contributor

lonasozo commented Aug 6, 2022

Hey guys, I've started to create the table contents for myself, I can create a pull request so we can work together

@lonasozo
Copy link
Contributor

Guys I think this should be closed (?)

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

No branches or pull requests

2 participants