Как мы потеряли GitBook за 5 минут и нашли Gramax — open-source альтернативу, которую теперь используем сами

Один клик — и ваша документация может исчезнуть. Именно так и произошло с нами. Поэтому мы нашли open-source альтернативу, где данными владеем только мы — и никакой регион это не изменит.

https://habr.com/ru/articles/1019230/

#Gramax #GitBook #open_source #документация #docsascode #Markdown #Git #стартап #альтернатива_GitBook #командная_документация

Как мы потеряли GitBook за 5 минут и нашли Gramax — open-source альтернативу, которую теперь используем сами

Пишет об этом Product Manager команды: Котельникова Екатерина Андреевна. Сегодня расскажу об одном из тех моментов, которые случаются у каждой команды: ты что-то настраиваешь, радуешься, нажимаешь...

Хабр

Rollout of the new docs look is done!

We have earlier stated the full freshening plan for all project documentation when it comes to projects, together with the rollout plan for this improvement. This improvement includes a new documentation look, which will make the docs easier to read with condensed sections, improved appearance, and more.

Now, we are very excited to announce the availability of the new look of docs for all projects!

The whole plan is now complete, but that doesn’t mean that this is the end of improvements; this is just the beginning, and improvements will be endless as we evaluate our docs and make them more fresh.

The new documentation look is now live on the official docs website, which you can access here.

Open the Aptivi Docs #docs #documentation #gitbook #github #news #Tech #Technology #update
Rollout of the new docs look is done!

We have earlier stated the full freshening plan for all project documentation when it comes to projects, together with the rollout plan for this improvement. This improvement includes a new documen…

Aptivi

Nitrocid’s old revived docs are now available!

We’ve just released Nitrocid 0.2.0 as part of the huge milestone today, alongside the branding kit. But, there is still more for this huge milestone!

The biggest thing has happened since the history of Nitrocid! We’ve managed to revive the old documentation of Nitrocid from version 0.0.6 to 0.0.23, which were released from 2019 to 2022. Now, the docs for those versions are now available in our GitBook instance!

Our excitement has reached the top, and this has got to be the biggest and the greatest preservation plan we’ve ever planned in the history of Nitrocid!

In our GitBook documentation, the following versions are now available:

  • 0.0.6.x: June 19th, 2019
  • 0.0.7.x: August 30th, 2019
  • 0.0.8 RC1: January 16th, 2020
  • 0.0.8 RC2: February 1st, 2020
  • 0.0.8 RC3: February 11th, 2020
  • 0.0.8.x: February 22nd, 2020
  • 0.0.9.x: April 23rd, 2020
  • 0.0.10.x: May 19th, 2020
  • 0.0.11.x: July 25th, 2020
  • 0.0.12.x: November 6th, 2020
  • 0.0.13.x: December 20th, 2020
  • 0.0.14.x: January 21st, 2021
  • 0.0.15.x: February 22nd, 2021
  • 0.0.16.x: June 12th, 2021
  • 0.0.17.x: July 4th, 2021
  • 0.0.18.x: August 2nd, 2021
  • 0.0.19.x: August 24th, 2021
  • 0.0.20.x: February 22nd, 2022
  • 0.0.21.x: April 28th, 2022
  • 0.0.22.x: June 12th, 2022
  • 0.0.23.x: July 12th, 2022

When we’ve released their documentation as part of the preservation project, we’ve preserved the history of how Nitrocid was documented when we first introduced it. It went from being a “booklet” for the project to a huge library of documentation, and most of the work traced back to our plan to refine the documentation for the first beta of 0.1.0 released on February 2023!

You can now take a look at the list of obsolete Nitrocid manuals by pressing the below button:

Open GitBook Docs #docs #documentation #gitbook #news #nitrocid #Tech #Technology #update
Nitrocid’s old revived docs are now available!

We’ve just released Nitrocid 0.2.0 as part of the huge milestone today, alongside the branding kit. But, there is still more for this huge milestone! The biggest thing has happened since the …

Aptivi
The documentation will be easier to navigate

The GitBook documentation for our projects will be easier to navigate than before. We have made earlier statements about how we’ll schedule changes made to the GitBook docs for all our projec…

Aptivi

The documentation will be easier to navigate

The GitBook documentation for our projects will be easier to navigate than before. We have made earlier statements about how we’ll schedule changes made to the GitBook docs for all our projects, starting from Nitrocid.

We are using different elements to make our documentation easier to navigate, that is, turning walls of text and long doc pages to expandable sections to make key information stand out and to shorten long pages in a way that makes the docs more comprehensive.

As we are reaching the huge milestone day, the docs will become easier to comprehend, as we are working towards the text flow across docs pages to ensure that all related information stays in one place instead of multiple spots in the same page.

Long sections have been broken down to multiple extendable sections, which can be extended by just clicking on the arrow to get more information. Similarly, multiple release notes have been made easier to read by making use of clear dates and changelogs, colored with the following types of change:

  • Green: This color indicates an addition of new features (for example, Added DotBlob screensaver)
  • Yellow: This color indicates an improvement or a bug fix (for example, Fixed crashes on startup)
  • Red: This color indicates a removal of features (for example, Removed native library dependency)

The changelogs will remain populated on GitHub as proper release markers for quick reference, in case documentation is not available.

Also, cards are used to group different features instead of individual page links to make the experience more welcoming, as well as links at the top of each card and the cover picture to give you a quick glimpse of a feature or an item.

This is a final reminder that the new documentation will get rolled out on February 12th!

#docs #documentation #gitbook #news #Tech #Technology #update

Rollout schedule for the new Aptivi documentation look

As we have stated earlier, we have planned to give our documentation a new look to modernize it and to make it minimal from the start for easier navigation.

The rollout is slated to start on February 15th, with the expected duration of the rollout being three days until the 17th, inclusively. However, there are exceptions applied to some projects.

The following documentation will be updated in this order:

  • Projects that will have their documentation updated on February 12th (exception)
    • Nitrocid (general rolling docs)
    • Terminaux (general rolling docs)
  • Projects that will have their documentation updated on February 15th
    • BassBoom (general rolling docs)
    • SpecProbe
    • VisualCard
  • Projects that will have their documentation updated on February 16th
    • Textify
    • Aptivestigate
    • Magico
    • Colorimetry
  • Projects that will have their documentation updated on February 17th
    • Nettify
    • Metalinker
    • ChemiStar
    • ResourceLab
    • Calendrier
    • BskyId
    • dotify
    • pushrepos
    • uprepos
  • Please note that this is the expected rollout schedule and there may be delays.

    Are you excited for the new documentation look?

    #Aptivi #documentation #gitbook #news #Tech #Technology #update

    Rollout schedule for the new Aptivi documentation look

    As we have stated earlier, we have planned to give our documentation a new look to modernize it and to make it minimal from the start for easier navigation. The rollout is slated to start on Februa…

    Aptivi
    February 2026, the month you’ve been waiting for!

    As of today, we have reached February, which is the month that you’ve been waiting for! Our excitement for what’s going to happen during this month is very high, and a huge milestone is…

    Aptivi