Notation

Hejka! Notation to zajebiste narzędzie, które umożliwia tworzenie dokumentacji w formacie markdown i automatycznie ją publikuje w Notion. Jak to działa? Po prostu piszemy swoją dokumentację w markdown. Potem tworzymy stronę w Notion do hostowania tej dokumentacji. Następnie zdobywamy klucz API z Notion (więcej szczegółów poniżej) i wrzucamy go do pliku ~/.notation/Notion.toml. No i potem odpalamy notation ship --src </path/to/you/docs>, żeby zobaczyć naszą dokumentację w Notion. I to nie wszystko! Notation ma też kilka ekstra funkcji. Na przykład intro.md, dzięki któremu możemy wysyłać treści bezpośrednio na stronę główną. Są też obsługiwane argumenty przekazywane jako flagi CLI w pliku markdown, takie jak tytuł i emoji strony. No i mamy różne opcje wdrożenia. Możemy utrzymać dokumentację wewnątrz naszego własnego workspace'u Notion dla zespołu, wysłać ją jako stronę Notion albo wdrożyć jako pełnoprawną stronę internetową z użyciem super.so. Jeśli macie jakieś pytania albo problemy, bez problemu możecie stworzyć zgłoszenie na Githubie. Czyli ogólnie, Notation to świetna rzecz dla tych, którzy chcą mieć łatwą i szybką metodę publikowania dokumentacji w Notion.