docs icon indicating copy to clipboard operation
docs copied to clipboard

split troubleshooting into several pages

Open Blind4Basics opened this issue 5 years ago • 1 comments

all in the title...

todo:

  • [x] update the tags once finished
  • [x] complete the sidebar in gridsome.config
  • [ ] write all the "subfiles"

Blind4Basics avatar Aug 03 '20 20:08 Blind4Basics

I think we need to understand what we're trying to cover first (topics) and think about what kind of information we should provide.

Current troubleshooting page is a mix of recipes (how to print), reference (error messages/signals), tutorial (posting comments), and also trying to help the reader find the information they need. It's doing too much and that's why it's difficult to split.

So instead trying to split the current page as is, I think we need to step back and think about it. After figuring that out, we can reuse parts of the troubleshooting page to write the new pages we need. Then provide an overview page that helps the reader find the information they need and link to those pages.

kazk avatar Aug 08 '20 02:08 kazk