Skip to content

Improve README#168

Merged
vrom911 merged 2 commits intomasterfrom
chshersh/better-readme
Jul 5, 2019
Merged

Improve README#168
vrom911 merged 2 commits intomasterfrom
chshersh/better-readme

Conversation

@chshersh
Copy link
Copy Markdown
Contributor

@chshersh chshersh commented Jul 5, 2019

I've noticed that README can be improved in several ways. Let me know what do you think.

@chshersh chshersh added the doc README, Haddock documentation, tutorials label Jul 5, 2019
@chshersh chshersh added this to the v0.6.0.0: Refinement milestone Jul 5, 2019
@chshersh chshersh requested a review from vrom911 July 5, 2019 06:45
@chshersh chshersh self-assigned this Jul 5, 2019
@chshersh chshersh force-pushed the chshersh/better-readme branch from 179bd29 to de46ff9 Compare July 5, 2019 07:11
Copy link
Copy Markdown
Member

@vrom911 vrom911 left a comment

Choose a reason for hiding this comment

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

Great improvements ❤️

README.md Outdated
+ Tutorial
+ Migration guide from `Prelude`
+ Haddock for every function with examples tested by [`doctest`](http://hackage.haskell.org/package/doctest)
+ Documentation regarding [internal module structure](http://hackage.haskell.org/package/relude/docs/Relude.html)
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Documentation on?

README.md Outdated
source file of your project. If you want to use some data types or functions
which are not exposed by `Prelude`, you need to import them, adding necessary
libraries to your project dependencies. Unlike ordinary libraries, alternative
preludes replace default functions and data types.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

"Replace functions and data types" could sound a bit scary when interpreted incorrectly... Probably somehow rephrase this?

README.md Outdated

### base

Multiple sorting functions are available without imports:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

without imports? probably this is an unnecessary phrase?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I just copy-pasted this part. But I agree that part about imports in redundant in the context of preludes. Thanks for noticing!

Copy link
Copy Markdown
Member

@vrom911 vrom911 left a comment

Choose a reason for hiding this comment

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

Amazing!

@vrom911 vrom911 merged commit 45f3bd7 into master Jul 5, 2019
@vrom911 vrom911 deleted the chshersh/better-readme branch July 5, 2019 10:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc README, Haddock documentation, tutorials

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants