Skip to content

Fix symlink for server installation documentation in README#393

Open
IanSkelskey wants to merge 1 commit intoevergreen-library-system:mainfrom
IanSkelskey:readme-symlink-fix
Open

Fix symlink for server installation documentation in README#393
IanSkelskey wants to merge 1 commit intoevergreen-library-system:mainfrom
IanSkelskey:readme-symlink-fix

Conversation

@IanSkelskey
Copy link
Copy Markdown
Contributor

We discussed this issue in the last GitHub working group meeting. We mentioned possibly making a separate markdown readme, but it looks like changing the format isn't necessary, we just need to tell GitHub what format to render with the symlink, which can be accomplished by adding .adoc to the symlink's name.

Currently, the readme isn't displaying correctly on github and looks like this:
image

After this update, it will render properly with formatting:
image

You can see it in action on the source branch for this PR:
https://github.com/IanSkelskey/Evergreen/tree/readme-symlink-fix

@gmcharlt
Copy link
Copy Markdown
Contributor

gmcharlt commented Jan 27, 2026

Great that GitHub knows how to render AsciiDoc!

There are a couple issues to sort out before this can be merged:

  • build/tools/make_release will need to be updated, as it munges the README during release
  • a bug should be opened on LP and the commit message refer to it; the commit should also have your signoff.

But to be clear, I support the idea.

@IanSkelskey
Copy link
Copy Markdown
Contributor Author

@gmcharlt Sounds good to me. Thanks for the prompt reply! I can work on that between now and the meeting this afternoon. Though my attention is a little split with snow removal (I'm in CT). ☃️

@IanSkelskey IanSkelskey force-pushed the readme-symlink-fix branch 2 times, most recently from 1718639 to b9790dc Compare January 27, 2026 18:49
Rename README to README.adoc and update the symlink to the server
installation documentation.

Signed-off-by: Ian Skelskey ianskelskey@gmail.com
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

Successfully merging this pull request may close these issues.

2 participants