Atlassian - sgml/signature GitHub Wiki

Best Practices

Best practice 1978 MLIS perspective Slack taxonomy perspective Jira taxonomy perspective LLM assistance in Slack LLM assistance in Jira
Reliance on structured metadata and controlled vocabularies Use catalog cards, MARC records, and subject headings for precise retrieval Use consistent channel naming and tags; rely on taxonomy fields instead of keyword search Use epics, labels, and components consistently; structured backlog reduces need for keyword search Suggest standardized channel names and tags; auto-detect inconsistent usage Recommend consistent labels/components; auto-tag issues based on content
Consistent naming Authority control ensures uniform headings; catalog integrity maintained Channels follow naming conventions (#project-alpha); tags standardized Labels standardized; epics named consistently; dashboards reliable Flag inconsistent channel names; propose renaming to match conventions Detect duplicate labels; suggest merging or renaming for clarity
Hierarchical categories Classification systems (Dewey, LC) provide browsable hierarchies Channels grouped logically; workspaces segmented by domain Epics and stories organized hierarchically; components define structure Recommend logical grouping of channels; suggest workspace segmentation Suggest epic/story hierarchies; auto-assign components based on issue metadata
Separation of subjects and formats Distinguish descriptive metadata from subject analysis; clarity in catalog records Channels dedicated to topics vs. functions; threads used appropriately Labels distinguish business domains from technical tags; issue types used correctly Identify mixed-topic channels; recommend splitting or restructuring Detect misuse of issue types; suggest corrections for consistency
Non-redundant, unique terms Controlled vocabulary avoids duplicates; retrieval precision preserved Single authoritative channel per topic; tags consolidated Labels unified ('frontend' standardized); components non-overlapping Detect duplicate channels/tags; recommend consolidation Identify overlapping labels/components; propose unification
Documentation and governance AACR2 rules guide cataloging; staff trained in standards Channel naming guide and taxonomy governance; admins enforce consistency Label glossary maintained; epics/components documented; sprint tagging standardized Auto-generate channel naming guidelines; provide governance suggestions Generate label/component glossaries; enforce taxonomy rules via automation
User-centered design Cataloging aligned with patron browsing habits; subject headings reflect user needs Channel taxonomy reflects user workflows; relevant spaces easy to find Taxonomy reflects developer/product needs; filters match workflows Analyze user behavior; recommend taxonomy aligned with usage patterns Suggest taxonomy refinements based on developer/product team workflows
Balanced granularity Subject headings subdivided only as needed; catalog remains usable Channels broad enough to encourage engagement; avoid micro-channels Labels/components broad but meaningful; dashboards uncluttered Flag overly granular channels; suggest merging Detect overly specific labels; recommend consolidation
Ongoing maintenance Catalog weeded; obsolete headings removed; MARC records updated Channels archived when inactive; tags pruned regularly Labels/components cleaned; legacy epics retired; reporting accurate Identify inactive channels; recommend archiving; prune unused tags Detect stale labels/components; suggest cleanup; retire legacy epics automatically

JIRA

Database Schemas

Documentation

  1. https://support.atlassian.com/jira-software-cloud/docs/markdown-and-keyboard-shortcuts/
  2. https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issue-fields/#api-group-issue-fields
  3. https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-custom-field-contexts/#api-group-issue-custom-field-contexts
  4. https://developer.atlassian.com/platform/forge/manifest-reference/modules/jira-custom-field/
  5. https://confluence.atlassian.com/jirakb/search-for-inactive-users-346947771.html
  6. https://media.readthedocs.org/pdf/jira/stable/jira.pdf
  7. http://scriptrunner-docs.connect.adaptavist.com/jiracloud/jql-aliases.html
  8. https://confluence.atlassian.com/jiracoreserver072/advanced-searching-fields-reference-829092671.html
  9. https://community.atlassian.com/t5/Jira-articles/Becoming-a-JIRA-Search-Ninja-History-searches-in-JIRA/ba-p/461943
  10. https://www.atlassian.com/blog/jira-software/jql-the-most-flexible-way-to-search-jira-24
  11. https://jira.atlassian.com/browse/JRASERVER-20359?jql=text%20~%20%22sqlite%22%20ORDER%20BY%20created%20DESC
  12. https://docs.atlassian.com/software/jira/docs/api/7.6.1/constant-values.html
  13. https://docs.atlassian.com/DAC/rest/jira/6.1.html
  14. https://confluence.atlassian.com/jirasoftwarecloud/advanced-searching-764478330.html
  15. https://jira.atlassian.com/browse/JRASERVER-60724

Tempo

  1. http://mutexoy.blogspot.com/2018/06/the-worst-api-ever-tempo-timesheets.html

Confluence

  1. https://developer.atlassian.com/server/confluence/expansions-in-the-rest-api/
  2. https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/
  3. https://docs.atlassian.com/atlassian-confluence/6.6.0/
  4. https://www.quora.com/Is-Confluence-a-good-CMS-for-a-corporate-intranet
  5. https://www.atlassian.com/blog/archives/publishing-kick-ass-websites-confluence
  6. https://www.addteq.com/blog/2017/07/3-ways-of-turning-confluence-into-your-website-s-cms

Bitbucket

  1. https://confluence.atlassian.com/bitbucketserver/bitbucket-server-config-properties-776640155.html
  2. https://docs.atlassian.com/bitbucket-server/rest/5.16.0/bitbucket-rest.html
  3. https://docs.atlassian.com/bitbucket-server/rest/4.9.1/bitbucket-rest.html
  4. https://developer.atlassian.com/server/bitbucket/reference/js-api/
  5. https://confluence.atlassian.com/bitbucketserverkb/how-to-diff-arbitrary-commits-using-rest-api-790630308.html
  6. https://confluence.atlassian.com/bitbucketserverkb/how-to-report-on-permissions-by-using-rest-api-endpoints-858696596.html
  7. https://community.atlassian.com/t5/Bitbucket-questions/Where-to-find-the-url-for-an-RSS-feed-of-commits/qaq-p/832308
  8. https://community.atlassian.com/t5/Bitbucket-questions/Post-Webhook-REST-API/qaq-p/731952
  9. https://docs.atlassian.com/bitbucket-server/rest/5.8.0/bitbucket-rest.html?_ga=2.78030548.1586964311.1554121058-2105203457.1554121058#idm46057173007120

Security

  1. https://www.atlassian.com/trust/policies

Interop

  1. https://www.atlassian.design/server/
  2. https://community.atlassian.com/t5/Jira-questions/I-would-like-to-track-Atlassian-product-releases/qaq-p/308308
  3. https://community.atlassian.com/t5/tag/rss/tg-p/tag-id/540
  4. https://en.wikipedia.org/wiki/Oracle_Beehive
  5. https://developer.atlassian.com/cloud/jira/platform/api-changes-for-user-privacy-announcement/