Suggestions for improving the documentation

Corteza and the documentation have come a long way since the early days but there are always things we could improve.

Use this topic to provide feedback, opinion, and suggestion for improvements regarding our documentation.
This is a free for all; anything from the structure to the contents; anything goes, just keep it constructive.

Thank you in advance for all of your valuable feedback!

The biggest thing for me is that there are useful functions in the app, but it should be reflected in the documentation right after being added in releases - there’s no point in adding functionality if even the more advanced users can’t use it because they don’t know about it. As an example, Corteza has been somewhat compatible with MSSQL and some other SQL engines for a while now, but there still is not any documentation on how to create config for these databases.

There are also a lot of “todos” in the documentation itself.

2 Likes

Thanks for the feedback.
If anything else pops up, do let us know :pray:

I’m newer to programming full web applications. The thing that I am finding the most difficult to navigate is when to use which type of function and what each of them do. Also, workflows feel really convoluted. I would love a few demos that walk through different examples and talks about where each piece of data is coming from and how it’s moving through the workflow.

2 Likes

So you’d suggest improvements to the docs or workflows?

I suggest better documentation on using workflow low-code blocks (how to use each of the function types, how the data is connected (from modules to other modules or to internal fields) through each workflow step, and how to write effective references in building expressions.

I think the walkthroughs would be helpful to make it more beginner friendly.

1 Like

Makes sense, thank you

1 Like

From what I’ve seen on other platforms, I think the documentation needs:

  1. Adding some chapters like: fundamentals, getting started, building your first app.
  2. Changing the order of some chapters to be more user-oriented: from the least advanced to the most advanced.
  3. Including some simple app examples of what could be built with Corteza Compose.
4 Likes