[Zero]

Now that I have a central store (CSMap), and a way to r/w it (IntentManager), I'm working on what will be stored in it.

Inspired from JSON-LD and OpenCyc, the general schema of a node is:

Code: text

{
    @id        // node's identifier
    @doc       // url of documentation
    @date      // last modification timestamp
    @path      // namespace

    @out {     // outgoing edges
        @isa   // classes of this instance
        @gen   // superclasses of this class
    }
    @in {      // incoming edges
        @isa   // instances of this class
        @gen   // subclasses of this class
    }
}

[infurl]

As you add data to your system you should also create automated consistency checks (regression tests) as you go. Ideally you want to get it to the point where you can add a little bit of information every day and immediately test to make sure you haven't broken anything, even if you don't remember everything that you already added. That way you can continue to build it up over time and not have to keep going back to the start and rewriting it all.

Another practice that will help you is to be able to freely convert the data that you do enter between formats. At the very least you should be able to automatically generate documentation from your data (a reference manual). Ultimately this will make it easier for other people to understand what you are doing and contribute to it. SUMO is a good example of a project like this which is mature, successful, and useful.