A brief introduction to Whiteboards, a new tool that facilitates a new form of collaboration between people. Why are we still talking about the documentation problem? In my previous post, we discussed the challenging topic of documentation management within a company, an aspect that’s often underestimated, and not properly rationalized and engineered. Also in this…
Read MoreThis post offers a simple and pragmatic way to manage your company’s knowledge base with an SaaS product like Confluence. Why are we always here talking about the documentation problem? The title of this post references the Panda, an endangered animal that has become a symbol of the WWF since its founding in 1961.The panda…
Read MoreWhen we talk about APIs, we developers are generally biased, and focus on how they’re implemented technically – how they work, how they integrate into larger systems – and we settle for that. But there’s a valuable part of API development that often gets overlooked: creating their descriptions. This practice tends to be undervalued, so…
Read MoreIn a companion post we talked about how to create a custom theme for Sphinx, like the one we made for the new NetEye online user guide.Sometimes just a basic customization is not enough and you want to create something much more advanced. In this article, we’ll look at some more detailed custom parts. Custom…
Read MoreDuring this release we worked a lot to improve the NetEye User Guide. The new user guide is now independent of the NetEye product itself, it can be found online and its structure is greatly changed. By this I mean that we improved not only its content, but we also decided to use a more…
Read MoreWouldn’t it be great to have quick access to your favorite pages in the NetEye documentation? To make customized thumbnail pages of your most frequent screenshots? To create your own alternative documentation index with categories reflecting your mindset? To add your own notes, comments, or FAQ with pointers into the existing NetEye documentation? That would…
Read MoreEriZone is mainly used as an (IT) SM tool to manage incidents, service requests and changes, and to document the assignment and return of devices. However, a ticket system like EriZone can also support other processes – for example, those that need to provide structured documentation. In fact, many standards require reporting risks or other…
Read More