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

Updated ReadMe in "updatedREADME" branch. #10107

Open
wants to merge 1 commit into
base: develop
Choose a base branch
from

Conversation

stephendsmith22
Copy link

The new README now includes a table of contents, better organization, images, a list of key features, a logo at the top, and some other information.

…ts, better organization, images, a list of key features, and some other information.
@tyrasd tyrasd added the documentation Improvements to the iD documentation label Feb 16, 2024
Copy link
Member

@tyrasd tyrasd left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey, thanks for the suggestions. Looks not bad in general, but maybe you could address the following points:

  • please replace the demo image with a lower resolution one: the image will be scaled to fit the width of the readme section on github. It does not really make sense to ship a 2560 pixel wide image whose details will be tiny, and the file size ends up unnecessarily large at 5MB
  • the demo image should be put directly into the img folder, not the dist one, right? currently, it does not load properly because of this
  • was it really necessary to change the listings from using * to -? This unnecessarily increases the number of edited lines in this PR and makes it harder to follow the actual changes. I'd prefer if you could change this back to how it was in the development branch. 😊

Cheers!

@tordans
Copy link
Collaborator

tordans commented May 3, 2024

Github added a native and automatic TOC feature a while back
image

I recommend to close this PR and extract things that might still be useful to a separate PR.

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

Successfully merging this pull request may close these issues.

None yet

3 participants