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

Update documentation framework with docusaurus #506

Open
wants to merge 41 commits into
base: docs/v-next
Choose a base branch
from

Conversation

davidnussio
Copy link

@davidnussio davidnussio commented Feb 24, 2021

Update documentation framework #459

  • Migrated old doc to new framework
  • Documentation search with local generated files (no Algolia service)
  • Integrated runnable examples with runkit

How to test:

  • Local develop: yarn start
  • Deploy on crocks.github.io/crocks: GIT_USER=evilsoft USE_SSH=true yarn run deploy
  • Change deploy url and baseUrl: change them in docusaurus.config.js

See PR in action

JacopKane and others added 30 commits September 8, 2019 11:51
* Correct project example of Tuple

* add myself to contributors
* Adding CONTRIBUTING.md

* Initial coding standards

* Spacing and line-break updates

* Updated coding standards with new structure/examples

* Further review updates
* add bichain to Either and Result

* update Async bichain specs

* clean up existing code a wee bit

* add links and bodys for all dem bichains

* add bichain to Maybe

* update doc examples
in the docs the property num had the same type as the example above.
the change makes clear the contramap is not working on a different property instead of the type
* Edit README (evilsoft#454)

- reorganize titles
- add documentation references
- add extra example

* Edit docs/functions/helpers.md#curry

- add `curry` examples
  - show use of curried functions with different combinations of
    parameters
- add `curry` examples with optional parameters
  - show possibly unexpected edge cases

* Make requested changes

- Use references instead of links in README
- Change the way optional parameters are warned against
- Conform to style in force
- Reserve comments above definitions for signatures
- Reserve first comment after function call for results
- Add textual explanation of the return type of `curry`

* Add requested changes

- update README to adhere to coding standards
- update `curry` docs
  - remove five input example
  - rename three input example
  - add definition to three input example
  - add definition to data
  - use double quotes for returned strings
  - reword caveat about optional parameters

* Remove superfluous `.map()` from examples

* Add sunwukonga as doc contributor
In case of a Left the object is added as the value of error instead of the value of the property 'a' transferred to 'error'
* update deps

* remove git add from lint-staged, no longer needed

* remove node:8 from travis, some deps no longer support it
Typo on either definition
Added a new `doc` contributor as @karthikiyengar suggested on this MR evilsoft#469 

Thanks :)

Co-authored-by: Dale Francis <[email protected]>
Fix typo

Co-authored-by: Dale Francis <[email protected]>
…t#475)

* Allow fn passed to Async.fromPromise to be partially applied

* Update docs to reflect changes to Async.fromPromise currying its input

* Update contributors
* Update CONTRIBUTORS.md

Adding in instructions on how to add to the list of contributors

* Update CONTRIBUTORS.md
Update import path from 'crocks/Pair/merge' to 'crocks/pointfree/merge'.
* Output result not correct 

Identity(42)
  .valueOf()
//=> 42 (Must be 42) not 33

Remove following lines

Identity(20)
  .concat(Identity(22))
  .valueOf()
//=> 35

due to this error message. Throwing error "TypeError: Identity.concat: Both containers must contain Semigroups of the same type"

* Addressing PR Comments

As discussed apply changes to Identity.md File.

* Add Spacing between array values
* Update Import path for 'merge' module-name

Update import path for 'merge' module-name from 'crocks/Pair/merge'  to 'crocks/pointfree/merge'.

* Add name to contributors List
@evilsoft
Copy link
Owner

Gonna give this a Play tonight! Amazing!

Quick question why were the comments in the code files changed to \** ... *\ from \\?

@davidnussio
Copy link
Author

I checked, there is a commit from master in the pull request (I forked the master to get an updated version of code)
Screenshot 2021-02-24 221750

@evilsoft
Copy link
Owner

Oh gotcha. Sorry I missed that.

@davidnussio
Copy link
Author

I broke CI but there is a warning message in travis:
Please be aware travis-ci.org will be shutting down in several weeks, with all accounts migrating to travis-ci.com. Please stay tuned here for more information.
Maybe this work could be moved to GitHub Action?

@dalefrancis88
Copy link
Collaborator

Not sure how i missed this PR coming in. Can check it out, nice work mate

@davidnussio
Copy link
Author

🎉 CI is 🟢 again
Lint was failing with JSX components into documentation js files

@davidnussio
Copy link
Author

@evilsoft @dalefrancis88 if the PR will be accepted could I submit crocks.dev to docusaurus showcase?

Immagine 2021-03-16 074500

@dalefrancis88
Copy link
Collaborator

I'll need to catch up with @evilsoft on this one but this is looking good

@kierans
Copy link

kierans commented Apr 23, 2023

Any update on this?

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.