Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add mdast-util-from-adf to list of utilities #40

Merged
merged 1 commit into from
Feb 22, 2022
Merged

Add mdast-util-from-adf to list of utilities #40

merged 1 commit into from
Feb 22, 2022

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