Skip to content

Conversation

klappradla
Copy link
Contributor

Initial checklist

  • I read the support docs
  • I read the contributing guide
  • I agree to follow the code of conduct
  • I searched issues and couldn’t find anything (or linked relevant results below)
  • If applicable, I’ve added docs and tests

Description of changes

Hi 👋

First off, thanks a ton for this great tool 💚

This PR adds the mdast-util-from-adf package to the list of utilities in the readme.

The mdast-util-from-adf package is a utility to build a mdast syntax tree from Atlassian Document format (ADF). ADF is a rich text format which Atlassian uses in most of its products (e.g. Jira, Confluence, etc.). It is "close" to Markdown, but not 100%. Combining this utility package with mdast-util-to-markdown allows escaping Atlassian's proprietary gardens into the freedom of widely used formats 🦋.

Background: My former colleague @pmeinhardt wrote the package to parse Jira tickets into Git commit messages and format them reasonably. It is used as part of a browser extension for Git conventions (https://github.com/bitcrowd/tickety-tick).

Maybe this package is helpful for others who are struggling with ADF as well ☮️

This adds the mdast-util-from-adf package to the list of utilities in
the readme (https://github.com/bitcrowd/mdast-util-from-adf).

The mdast-util-from-adf package is a utility to build a mdast syntax
tree from Atlassian Document format (ADF). ADF is a rich text format
which Atlassian uses in most of its products (e.g. Jira, Confluence,
etc.).

See: https://developer.atlassian.com/cloud/jira/platform/apis/document/structure/

ADF is "close" to Markdown but not 100%.
@github-actions github-actions bot added 👋 phase/new Post is being triaged automatically 🤞 phase/open Post is being triaged manually and removed 👋 phase/new Post is being triaged automatically labels Feb 22, 2022
@wooorm wooorm changed the title Add mdast-util-from-adf to list of utilities Add mdast-util-from-adf to list of utilities Feb 22, 2022
@wooorm wooorm merged commit 27f6550 into syntax-tree:main Feb 22, 2022
@wooorm wooorm added 💪 phase/solved Post is done 📚 area/docs This affects documentation labels Feb 22, 2022
@wooorm
Copy link
Member

wooorm commented Feb 22, 2022

nice, thanks!

@github-actions

This comment has been minimized.

@github-actions github-actions bot removed the 🤞 phase/open Post is being triaged manually label Feb 22, 2022
@wooorm
Copy link
Member

wooorm commented Feb 22, 2022

Maybe an idea to add a little movie/gif to bitcrowd/tickety-tick, to show how it enhances branch names/commit messages? It looks useful, but from the readme I don’t quickly glance what input will result in what output!

@klappradla
Copy link
Contributor Author

Maybe an idea to add a little movie/gif to bitcrowd/tickety-tick, to show how it enhances branch names/commit messages? It looks useful, but from the readme I don’t quickly glance what input will result in what output!

You're the 2nd person to request that. Moving it up on my list of things to do 🚀

Thanks 💚

@klappradla klappradla deleted the add-mdast-util-from-adf-to-list-of-utilities branch February 22, 2022 09:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
📚 area/docs This affects documentation 💪 phase/solved Post is done
Development

Successfully merging this pull request may close these issues.

2 participants