-
Notifications
You must be signed in to change notification settings - Fork 64
Update README.md #157
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 README.md #157
Conversation
adobeDan
left a comment
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.
I think fixes are needed. See the comments.
README.md
Outdated
| @@ -1,3 +1,16 @@ | |||
| # Adobe User Sync Tool | |||
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.
It's a pretty sacrosanct Github tradition to tile the readme with the project name. Is there really a need to violate that here?
README.md
Outdated
| @@ -1,3 +1,16 @@ | |||
| # Adobe User Sync Tool | |||
|
|
|||
| The Adobe User Sync Tool is a command-line tool that moves user and group information from an organization's enterprise | |||
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.
"Adobe User Sync Tool" violates brand name guidelines and can't be used. You have to say "User Sync Tool from Adobe"
README.md
Outdated
| - [Step-by-Step Setup](https://adobe-apiplatform.github.io/user-sync.py/success-guide/) | ||
| - [Non-Technical Overview](https://spark.adobe.com/page/E3hSsLq3G1iVz/) | ||
|
|
||
| # user-sync.py |
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 header and the first paragraph now seem redundant. The material in the second paragraph (open source, etc., and the copyright) need to be further up in the file, as in immedately after the first paragraph.
I also think you can remove the Overview section, and go to Requirements right after Quick Links.
adobeDan
left a comment
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.
Perfect, and nice solomonic solution to the header issue :).
No description provided.