Everything else
Start from what you are seeing rather than from what you think is broken. Each page below names the symptom, explains why it happens, and says what to do about it.
Several of these are the product working as designed, which is worth knowing before anybody raises a ticket.
#At a glance
Symptom | Usually because |
|---|---|
Capable Markdown global page shows no results, even though issues do have .md attachments | The page is driven by a search index that is only written when the app is licensed. The attachment triggers that maintain it are filtered to licensed sites, so an unlicensed site never gets |
Markdown files that were on issues before the app was installed never show on the global page | There is no backfill and no scheduled reindex. The index is written only when an attachment is created or deleted after installation. |
Edited document lost its old attachment id, and the issue history shows an attachment deleted and re | Editing works by deleting the existing .md attachment and uploading a replacement. There is no in-place update. |
Document disappeared after saving an edit, with no error shown | The save deletes the old attachment first and then uploads the new one. If the upload fails, the failure is swallowed and nothing is displayed. |
Renaming a document made the old one disappear, or two tabs now share the same name | The title is the filename. Renaming uploads a differently-named file, and nothing checks whether a name is already in use. |
Created column and the list order on the global page do not reflect when someone last edited a docum | Both use the attachment's created date, not an edit time. Editing re-uploads, so an edit does refresh it, but only if the index was updated. |
Fenced diagram block renders as plain code instead of a picture | Either the language is not one of the 27 supported diagram languages, or no signed-in session token was available, in which case the block is left as-is with no error. |
Someone else changed the tab order for everyone on an issue | The sort preference is stored on the issue, not on the user, so it is shared by all viewers of that issue. |
Getting started view keeps coming back | The dismissal is stored in browser localStorage, not on the server. |
Global page fails or returns nothing when filtering by a particular project | Project keys are inserted into the search query without quoting, so a key needing quotes breaks the query. |
Picking a template wiped work already typed in the editor | Choosing a template replaces both the title and the entire body. |
Viewer shows 'Invalid markdown provided' instead of the document | The content did not look like Markdown to the viewer, which names the language it detected instead of rendering the file. |
There is no way to restrict who can add Markdown, turn diagram languages on or off, point diagrams a | |
Security review asks where document content and diagram source go | All external addresses are declared as not in scope for end-user data. |
#In this section
#Related
Most of these are expected behaviour.
