We are happy to announce another release focusing on editor and appearance improvements.

Inline FontAwesome icons

Font Awesome is the world's most popular icon set and toolkit. As of 2020, Font Awesome was used by 38%, and the icon library consists of over 2,000 elements.

With the addition of inline FontAwesome icons, you can now:

• use the (fa) shortcut in the Archbee editor to add an inline icon from the FA icon library;

• change the icon for Spaces, Categories, or Documents with FontAwesome icons, not just with emojis.

Insert images in lists

Now you can add images to lists. Usually, you would have a numbered list to explain some steps. And one of them would need an image to provide better context.

Here's how you do that with Archbee.

1. start your list
2. add your steps
3. when you need an image, type /, and add the image block

Content layout settings

We introduced the 2 column layout for API endpoint and Code Drawer blocks in the previous release. Now we offer more controls around the Content Layout.

Go to Space settings, Appearance, and choose between 1 column and 2 column layout.

Other improvements

Now when you add an icon to a Space, it will be available in the tabs on the production website.

Another improvement is around shortcuts now; emojis are available when using the : symbol.

We've done it. Today we ship some of the hardest features we've ever shipped, with the best team we've ever had.

1. Code Drawers

Code drawers are a way to show code examples in a 3-column layout. Multi-languages are available and even responses.

When you have multiple code drawers in one doc, scrolling to the current one will change the code examples in the third column. To show the current section only.

2. 3-Column layout

This new layout automatically appears when blocks like `API Endpoint`, `OpenAPI` and the new `Code Drawer` are available in the document.

It's a new way to present annotated API information so that your users are taken to the exact context they need to be in as to understand how to use your API.

The view is also available in public documentation.

3. A new version workflow + language localization

Previously creating versions was a hassle and little understood. We've made it better.

Now you can choose where to start the new version from and label each version accordingly.

On top, we've made it possible to create language translations, every element of the UI being translated on top of the content that you'll create. We support English, French, German, Spanish, Italian and Russian at the moment and adding more as we see more usecases from you our customers.

The new versions also show in a neat new way when editing the content, in the left navbar.

4. Tens of design and UX features improvements to keep your documentation workflow going — and we're bringing more.

Hoping to get your feedback and stay tuned for next releases!

We have received your feedback!

Preview links are a great opportunity for your team to review and give feedback on the work being done. We recognized this when we built the feature, but every change you made went automatically to these links. Because unfinished work went there, it wasn't ideal for reviewing.

We've now changed it, and preview links work exactly like production (with domain) links.

Hit publish, copy the link, send it to your teammates, get reviewed and suggested changes applied, then hit publish to production!

Happy documenting!

Feature velocity at Archbee is a thing, and we take pride in shipping new features fast 🏎

After we launched Reusable Variables, a week later, we are proud to announce another component of the Reusable Content feature.

Meet Content Snippets.

Content snippets are blocks of content that you create once and can be placed on multiple document pages, allowing you to edit the content from a single place to update any portion of the documentation.

If you ever need to use the same content repeatedly in a few documents, you can create a Snippet to hold those elements.

How to use Content Snippets

A Content Snippet can be anything from a Code Block, an Image, a list of steps for the installation, you name it.

You can use Snippets with any of the 30+ custom blocks Archbee editor provides.

For example, if you need to mention the installation steps across multiple Spaces, you can create/edit a Content Snippet. While editing the Snippet, you can include sample code along with the numbered list. 

After creating a Content Snippet, you can use it in the editor by typing the forward slash, clicking on the content snippets tab, and selecting the Snippet you want to use.

When you need to change the contents of the Content Snippets you can edit them through the Reusable Content window of the app.

As always, we would hugely appreciate your feedback, so if you want to try Content Snippets, go to your account and use the in-app chat to talk with us.

Hey!

We've been super busy over the last few weeks, and we're excited to share the updates! 🎉

You ask, we deliver! We've released a new feature called Reusable Variables as part of the more extensive Reusable Content update. ⚡️

Now you have another great way to write documentation because Reusable Variables allows you to define repetitive words or phrases in a single place but use them across multiple documents.

It's a placeholder that stores a value. Here are some examples of things you might show in your docs that are subject to change, and you might want to use a variable:

• API keys
• API versions
• client name
• user id
• user name
• company name
• email
• phone number

Now, instead of going to each document to change the text, Reusable Variables saves you time because you can control them from one place.

When you change the variable's value, it will reflect across all documents.

How to use them?

First, you define the variable's name.

Next, you give the variable a value, which can be a single word or a phrase.

Now, you can insert these variables into your document by typing {{, and a list with the available variables will show.

Next, you can filter by the name to select a variable.

Learn more about using Variables or sign in to try them immediately!

Some changes we've made to allow a better user experience.

1. Staging becomes Preview

Our Staging environment has been renamed to Preview environment and is now publishable — just as the Production environment. Now everybody can preview their documentation sites BEFORE setting their domains — a huge time saver.

On top of that, the Preview environment is now authenticated by default for users already authenticated in Archbee. This makes it possible to create your documentation site privately and make it public only when it's ready, and you've configured it for Production.

2. Collections become Spaces

For many people `Collection` does not reflect what we mean.

Now Spaces, collections were meant to be the first layer of document organization. Spaces sound more familiar from similar software that's focused on internal documentation.

Basically:

• Documents are organized into Spaces;
• Spaces are organized into Sites (which we'll introduce shortly).

3. Workspaces become Orgs

Our Workspaces feature allows you to use a single login to be in the context of multiple companies, negating the need to re-login with another account. 

This is great. However, many users get confused by the concept, buy a subscription and assume it's for all Workspaces they create. Each workspace has its own subscription because what we really mean by workspaces is "organization". 

We considered a switch to "Teams" but we realized it could also mean that there are separate teams in an organization. So we're making this semantic change to reflect that.

4. Code Editors Update

All code editors have been updated to allow multiple tabs using the same language, drag and drop to reorganize tabs, and performance improvements.

5. Better Markdown converters

We've made a bunch of modifications to our Markdown converters and now they catch more of our custom blocks, that were previously hard to translate to markdown. For example, our Link Blocks and Tabs now translate to a custom Markdown directive, that we understand and other software can easily be made to understand.

6. Removing favorite collections (now spaces)

The favorite collections (now spaces) feature has been removed, for various complicated reasons. You can still drag and drop spaces to organize them as you see fit, potentially putting spaces you care more about at the top of your list.

7. Lots of UI changes and improvements

We've reorganized many things around the UI to build a better user experience.

Cheers from the fearless Archbee team, meaning is not afraid to deploy to prod on Fridays or any other day 💪

At least that we can do to feel 0.1% as brave as Ukraine people.

#WeAreWithUkraine 🇺🇦

1. GitHub

With GitHub you can write docs-as-code in Markdown files. It syncs automatically to an archbee collection where it can be shared internally with non-technical team members. On top of that, you benefit of the same public sharing mechanism as every other collection..

It's a one-way sync (from GitHub to Archbee) by design. We believe git as a system works great because there is a human interaction requirement — when merge conflicts arise, somebody will need to manually merge the content in the files. When one side of the system is automated (as it would be in our case if the integration would be 2-ways), a 2-way system would not be able to protect your content from being injured in the process.

You can then easily publish the collection to your domain, and combine it at will with WYSIWYG collections to build your docs sites.

Note: Our GitHub/git integrations are just at the beginning. We plan to create another editor block that references chunks of code in the repositories to let you document SDKs and keep them in sync with the code. Similarly to our Doc Verifications feature, the new block will prompt you when the code goes out of sync with the documentation in archbee. This will be a great feature to have when internally onboarding developers as well, allowing you to create sequences to take them through your codebase if necessary. This is one of our major features to launch next Q.

2. JIRA

Now you can paste JIRA issues after adding the integration, and they'll be automatically embedded in Archbee docs (and the content kept in sync). 

Our JIRA integration works well now, and we're looking to expand its capabilities based on your input. 

Happy documenting from the Archbee team!

Public docs authentication for your customers is hard in Archbee if you don't use the JWT integration.

It's hard to share a password with all the stakeholders. Especially when the password changes.

It's hard to manage accounts and passwords for the stakeholders.

With Magic Links you can now add their email address or their domain address, and they will be able to authenticate solely using their email. We just send them a link that authenticates them on click.

Here's how it looks like down below. 

Check out our docs for examples and details:

https://docs.archbee.io/expandable-headings