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

Formatting Improvements to Synopsis in README #220

Merged
merged 3 commits into from
Sep 11, 2024

Conversation

joshstephenson
Copy link
Contributor

@joshstephenson joshstephenson commented Sep 8, 2024

resolves #219

I can't say this is perfect, but it's consistent. I used the "python console" technique for code blocks which I think is a good way to display both the code and the output.

In a few sections I added a few more examples to expose a bit more functionality. I wouldn't blame you if you don't love that considering it's a synopsis.

One area where I am not clear on the functionality is the overrides for verbs. It might be helpful to readers to have an example that demonstrates the changes.

After rereading the Description section I think it looks fine, although it does reference "see MODERN VS CLASSICAL INFLECTIONS" which doesn't appear to be on the page.

Cheers!

First pass at new formatting for synopsis
Second pass. Everything has been addressed. Pending proof read.
Third pass for format updates to synopsis section.
@jaraco
Copy link
Owner

jaraco commented Sep 11, 2024

Looks amazing. Thanks!

@jaraco jaraco merged commit d671de6 into jaraco:main Sep 11, 2024
15 checks passed
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.

Improving the formatting of the README, particularly the giant code block under SYNOPSIS
2 participants