Communities

Writing
Writing
Codidact Meta
Codidact Meta
The Great Outdoors
The Great Outdoors
Photography & Video
Photography & Video
Scientific Speculation
Scientific Speculation
Cooking
Cooking
Electrical Engineering
Electrical Engineering
Judaism
Judaism
Languages & Linguistics
Languages & Linguistics
Software Development
Software Development
Mathematics
Mathematics
Christianity
Christianity
Code Golf
Code Golf
Music
Music
Physics
Physics
Linux Systems
Linux Systems
Power Users
Power Users
Tabletop RPGs
Tabletop RPGs
Community Proposals
Community Proposals
tag:snake search within a tag
answers:0 unanswered questions
user:xxxx search by author id
score:0.5 posts with 0.5+ score
"snake oil" exact phrase
votes:4 posts with 4+ votes
created:<1w created < 1 week ago
post_type:xxxx type of post
Search help
Notifications
Mark all as read See all your notifications »
Q&A

Post History

71%
+3 −0
Q&A How can we integrate a lightweight public ticketing system into our documentation feedback form?

We publish a substantial documentation set online. Each page has a place at the bottom that asks "was this helpful? (Y/N)", and if the person chooses "no" we offer a textbox. We collect all this ...

3 answers  ·  posted 3y ago by Monica Cellio‭  ·  last activity 9mo ago by Monica Cellio‭

Question software tools
#1: Initial revision by user avatar Monica Cellio‭ · 2021-07-08T01:19:12Z (over 3 years ago)
How can we integrate a lightweight public ticketing system into our documentation feedback form?
We publish a substantial documentation set online.  Each page has a place at the bottom that asks "was this helpful? (Y/N)", and if the person chooses "no" we offer a textbox.  We collect all this feedback internally (it feeds into our internal ticketing system, except for the spam), but to the user, it feels like typing feedback into the void -- you never know when there'll be followup.  Further, because the communication is one-way, we can't ask people to clarify comments when needed.

We would much rather have a public tracking system for these issues, where the response to the form submission would include a link with an invitation to track this issue.  (We'd rather not ask for email addresses; this should feel completely opt-in and safe to the person offering us the feedback.)  We want to find a place to host tickets that the public can follow and that we can update (either to say we've fixed it or to ask for more information).  I'm imagining that all of these tickets would be created by us (well, by our feedback system) in response to the in-doc feedback, at least initially.

What tools should we consider?  Opening our internal ticketing system to the public is not an option.

If we were managing our code (or documentation) on GitHub then using GH issues for this would seem obvious, but we're not, so it feels strange to create a project just to "host" issues for some other system.  We're a for-profit corporation, not a non-profit or open-source project, and we don't want to step on toes or give a bad look by misusing tools meant for a different context.  We also don't have a lot of money to spend on this and need to keep administration simple.