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

Add an FAQ to the Developer and User documentation sets #414

Open
mikelittle opened this issue Aug 24, 2022 · 1 comment
Open

Add an FAQ to the Developer and User documentation sets #414

mikelittle opened this issue Aug 24, 2022 · 1 comment

Comments

@mikelittle
Copy link
Contributor

Each of the documentation sets -- Developer and User -- should have FAQs.

It will be worth waiting until there are at least four or five items for each before publishing.

However we could work on the content of them in this ticket or other linked tickets.

@owaincuvelier
Copy link
Contributor

I'm been thinking a lot about the FAQs a lot, and one thing that's stopped me is how I've wanted the FAQ to be as accessible as possible to editors. I hate editing in GitHub and it's terrible for making fast on-the-fly edits to documentation, this is why I've not started an official FAQ to date.

As you noted, there is a minimum amount of FAQs before we can publish anything so similarly I've started, but not published an FAQ here: https://humanmade.zendesk.com/hc/en-us/categories/6967490172051-FAQ but I still hadn't decided how many FAQ articles before publishing was enough, and I admitidly wasn't too thrilled about using Zendesk Guides as the FAQ location, prefering all docs to be in a single location. That said, not having an FAQ helps no one, so its time to bite the bullet.

What is the page structure you had in mind for this? A single header FAQ with sub pages? Or all the FAQs on a single FAQ page?

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

No branches or pull requests

2 participants