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

Quickstart docsify-powered documentation #451

Open
wants to merge 3 commits into
base: master
Choose a base branch
from

Conversation

phndiaye
Copy link

@phndiaye phndiaye commented Oct 31, 2021

Related to: #450

Rendered

This is a quickstart of the documentation update using Docsify. Basically all the content of the README has been moved into different sections of the documentation website.

For multiple sections, I took the liberty to use more recent syntax (Octane) instead of the Ember Classic one. For the rest, I kept the existing content (sometimes rephrased it a bit but nothing more).

I also removed some parts that needed to be in a Changelog and not necessarily in the documentation itself.

@phndiaye phndiaye changed the title Split the documentation and serve it using Docsify Quickstart docsify-powered documentation Dec 1, 2021
@patocallaghan
Copy link
Collaborator

@phndiaye any chance you could rebase against master please and resolve the current conflict?

@phndiaye
Copy link
Author

@patocallaghan Updated :) the last updates in the README were about using newer syntax for models, which is now done in the doc itself

docs/.nojekyll Outdated
Copy link
Collaborator

Choose a reason for hiding this comment

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

Any idea what this file is required for?

Copy link
Author

Choose a reason for hiding this comment

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

It's because Jekyll (through Github pages) interprets files starting with a leading _ as "special" and this file bypasses that behaviour.

- ⭐ Works out of the box with your existing serializers and adapters
- 💎 Multiple build strategies
- 🕵️ Intercept and spy on Store requests
- 🕐 Slow down response times
Copy link
Collaborator

@patocallaghan patocallaghan Mar 17, 2023

Choose a reason for hiding this comment

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

Could we add links to all of the other pages until a time we get the site online into a public site? When we merge this PR the docs will only be available in these markdown files and won't be that discoverable

Copy link
Author

Choose a reason for hiding this comment

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

@patocallaghan Sorry for the delay here :/ finally added a table of content to discover the documentation from the repo itself

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.

2 participants