Hey Brent, nice job bringing back the FAQ. I added a new question to it,
and I'm wondering if we could do better on our organization of it. Or
rather, be more clever with confluence. I'm thinking of organizing into
children sections, of the categories, and sub-children, of the actual
questions, and hoping we can then maybe autogenerate the table of
contents. I found it a bit tiresome to have to figure out which anchor to
use, having to get all the names right. Would be nice to auto-generate.
I didn't say anything, because it's fine, but I'm now thinking we could
get a big benefit from this. I'm making a slight improvement to the
datastore tutorial, but I also want to add the new FAQ question I made to
the 'troubleshooting' section of shapefile. I could put a link, but I
think it would be even nicer if we could just {include} the FAQ questions,
so whenever one is modified, the troubleshooting section is also instantly
updated. Thoughts? I've not played with this yet, so I'm not sure if
it's possible, but I'd like it _super_ easy to add a new FAQ
question/answer.
It would be great to make the FAQ a lot easier to use, right now it is a bit of a pain. I haven't found an easy way to do it in Confluence yet, and I have a feeling we will have to use another tool to do it, maybe a plugin to Confluence. I will take a look around today and see what options we have.
cheers
Brent Owens
TOPP
Chris Holmes wrote:
Hey Brent, nice job bringing back the FAQ. I added a new question to it, and I'm wondering if we could do better on our organization of it. Or rather, be more clever with confluence. I'm thinking of organizing into children sections, of the categories, and sub-children, of the actual questions, and hoping we can then maybe autogenerate the table of contents. I found it a bit tiresome to have to figure out which anchor to use, having to get all the names right. Would be nice to auto-generate. I didn't say anything, because it's fine, but I'm now thinking we could get a big benefit from this. I'm making a slight improvement to the datastore tutorial, but I also want to add the new FAQ question I made to the 'troubleshooting' section of shapefile. I could put a link, but I think it would be even nicer if we could just {include} the FAQ questions, so whenever one is modified, the troubleshooting section is also instantly updated. Thoughts? I've not played with this yet, so I'm not sure if it's possible, but I'd like it _super_ easy to add a new FAQ question/answer.
There are plugin for confluence, I have not seen one for a FAQ yet.
You can just add a children macro and proceed from there, I have done that on the uDig site.
There is one Problem with this - at least on an earlier version of confluence - making a page with "?" in the title resulted in something that was hard to edit/delete etc... I will try it and see if this is still a problem.
The macro I used was this:
{children:depth=2|style=h3|excerpt=true}
For each "Questions" page, have a plain {children} macro.
Jody
Hi Chris,
It would be great to make the FAQ a lot easier to use, right now it is a bit of a pain. I haven't found an easy way to do it in Confluence yet, and I have a feeling we will have to use another tool to do it, maybe a plugin to Confluence. I will take a look around today and see what options we have.
cheers
Brent Owens
TOPP
Chris Holmes wrote:
Hey Brent, nice job bringing back the FAQ. I added a new question to it, and I'm wondering if we could do better on our organization of it. Or rather, be more clever with confluence. I'm thinking of organizing into children sections, of the categories, and sub-children, of the actual questions, and hoping we can then maybe autogenerate the table of contents. I found it a bit tiresome to have to figure out which anchor to use, having to get all the names right. Would be nice to auto-generate. I didn't say anything, because it's fine, but I'm now thinking we could get a big benefit from this. I'm making a slight improvement to the datastore tutorial, but I also want to add the new FAQ question I made to the 'troubleshooting' section of shapefile. I could put a link, but I think it would be even nicer if we could just {include} the FAQ questions, so whenever one is modified, the troubleshooting section is also instantly updated. Thoughts? I've not played with this yet, so I'm not sure if it's possible, but I'd like it _super_ easy to add a new FAQ question/answer.