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

Enhancements and fixes to documentation #2584

Closed
wants to merge 15 commits into from
Closed

Enhancements and fixes to documentation #2584

wants to merge 15 commits into from

Conversation

ljessicc
Copy link

@ljessicc ljessicc commented Apr 16, 2021

Please preview the changed/updated page/image links, and other miscellaneous changes to the doc/ files

@M-Davies M-Davies linked an issue Apr 16, 2021 that may be closed by this pull request
10 tasks
@M-Davies M-Davies added documentation Issues that request updates to our documentation enhancement Issues that enhance the code or documentation of the repo in any way labels Apr 16, 2021
@M-Davies M-Davies added this to the April 2021 milestone Apr 16, 2021
Copy link
Contributor

@karianna karianna left a comment

Choose a reason for hiding this comment

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

Didn't cover all of it, but a little more fine-tuning required :-)

md-docs/CONTRIBUTING.md Outdated Show resolved Hide resolved
md-docs/FAQ.md Outdated Show resolved Hide resolved
md-docs/README.md Outdated Show resolved Hide resolved
md-docs/README.md Outdated Show resolved Hide resolved
md-docs/README.md Outdated Show resolved Hide resolved
md-docs/README.md Outdated Show resolved Hide resolved
md-docs/README.md Outdated Show resolved Hide resolved
md-docs/README.md Outdated Show resolved Hide resolved
@karianna
Copy link
Contributor

Also, can you please edit this title with a description of the change :-)

Copy link

@M-Davies M-Davies left a comment

Choose a reason for hiding this comment

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

Great start. Got a few points of my own.

  • Could probably just called the md-docs folder docs/ as it's generally more obvious that the folder contains docs that way
  • See below

md-docs/FAQ.md Outdated Show resolved Hide resolved
md-docs/RELEASING.md Outdated Show resolved Hide resolved
md-docs/RELEASING.md Outdated Show resolved Hide resolved
@ljessicc
Copy link
Author

Alright I will work on these. Thanks @karianna

@ljessicc
Copy link
Author

could please review the updated changes as per previous reviews? Renamed md-docs to docs/, replaced and updated deleted links

@smlambert smlambert changed the title Jessy lj Enhancements and fixes to documentation Apr 20, 2021
Copy link

@M-Davies M-Davies left a comment

Choose a reason for hiding this comment

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

One final comment (sorry I missed this in my original review) and then LGTM

docs/FAQ.md Outdated Show resolved Hide resolved
docs/CHANGELOG.md Outdated Show resolved Hide resolved
@ljessicc
Copy link
Author

ljessicc commented Apr 21, 2021

I did my final commits after correcting generated lint code errors. If there's anything else required, I'd be glad to work on it.

@ljessicc ljessicc requested a review from karianna April 23, 2021 18:09
@ljessicc
Copy link
Author

please review and merge changes if ok. Thank you

…-support to github.com/adoptium/adoptium-support
@karianna
Copy link
Contributor

You have a merge conflict

@ljessicc
Copy link
Author

@karianna ok, looking into it. Thank you

@karianna karianna modified the milestones: April 2021, May 2021 May 18, 2021
@karianna
Copy link
Contributor

@ljessicc looks like merge conflicts still sorry :-(

@karianna karianna modified the milestones: May 2021, June 2021 Jun 6, 2021
Copy link
Member

@sxa sxa left a comment

Choose a reason for hiding this comment

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

I'm not convinced by the moving of the .md files at the top level - some of those are too much of a standard convention. I think README.md CONTRIBUTING.md and FAQ.md should definitely stay at the top level of the project.

@karianna
Copy link
Contributor

This has been superseded - thanks for your submission!

@karianna karianna closed this Sep 10, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Issues that request updates to our documentation enhancement Issues that enhance the code or documentation of the repo in any way security
Projects
None yet
4 participants