Skip to main content

We have a blog now!

· 3 min read
Guille
Docs Maintainer

Check check check. Is this thing on? Hello, world!

Hello there!​

Welcome to the new NEAR documentation blog! We're excited to inaugurate this new space where we can share news and updates. We know what you are thinking — why a blog? Well, it allows us to interact with you in a different way!

When writing documentation, it is important for us to keep the content focused and concise. This way, when you read it, you have nothing to distract you, and you can focus on learning a new concept.

The problem with this is that many times, we want to share ideas, thoughts, or insights into why some things are the way they are. However, this would imply going off on a tangent and explaining why some decisions were made, which will probably add noise to the document. Most of the time, users just want a link to an example or working code. Also, people don't like to read long texts.

Besides that, sometimes we just want to share what we did during the week. For example, did you notice that we fixed the nightmare that was the URL structure, or that we added new landing pages for all concepts? We want to share these things with you, but they don't really belong in the Docs.

tip

You would not believe the number of times we said during a review "let's remove that, we are writing technical documentation, not a blog post" ... well, now we can make the blog post!

What to expect​

We will be using this space to share updates about our docs, as well as complement them with additional information that we think you'll find interesting.

Our aim is to keep the blog updated at least once a week, but given the limited amount of time we have, we will see how that goes.

Moreover, we want to remind you that our Docs are an open source and collaborative project. If you feel like you have something to share, or want to contribute to the blog, feel free to reach out. And by reaching out, we mean opening a PR!

A new era for NEAR docs​

We are super excited to start this new section and hope it helps us to connect with all of you in a better way. We are looking forward to hearing your thoughts and feedback, and hope you enjoy the content we'll be sharing.

See you in the next post! 🚀