Stories
Slash Boxes
Comments

SoylentNews is people

posted by martyb on Saturday April 23 2016, @10:12AM   Printer-friendly

Emacs org-mode is very powerful tool for personal knowledge management, but can be hard to learn, makes it hard to have the same content (notes) referenced in more than one place, and can be awkward for the hands. Finding other tools inadequate for various reasons, I wrote OneModel to meet my own needs, and made it available. If you touch-type, it is extremely fast for to-do lists and notes of all kinds, and I generate the project web site from part of its data. It is much easier to learn and faster to navigate than emacs, and you can have the same content in as many places as desired, without duplication.

But it wants to be more: It uses an internal structure that has big future ideas for knowledge management, like embedding code within groups of entities, or linking across OneModel instances, so you can choose to share data from your personal organizer, or subscribe to (or copy) data from other instances: like a wikipedia but where the internal knowledge is structured so can be used for computation, rich queries etc. Imagine asking a system: what villages in history had economic improvements in a 4-year period, all external conditions being equal, and what do those cases all have in common?--that is the long-term vision of the system. The vision and internal structure are intended as be a prototype of a platform to manage all mankind's knowledge as a usefully computable whole.

The web site has a few screen shots (remember it's an ugly prototype but works well! -- I have my calendar/life notes/todos/contacts etc in it now) and a demo system to play with without installing anything.

(It is written in scala, using a simple/approachable coding style that should be readable by most programmers with just minutes of scala knowledge--I hope--and uses postgresql for the data.)

I frankly don't mind if someone else takes the ideas and does a better job with them: we can do better than managing mankind's knowledge in the form of huge sophisticated piles of words: words are not the real knowledge but a superstrate over it, and they are hard to compute well. Feedback welcome.


Original Submission

 
This discussion has been archived. No new comments can be posted.
Display Options Threshold/Breakthrough Mark All as Read Mark All as Unread
The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
  • (Score: 2, Insightful) by Anonymous Coward on Saturday April 23 2016, @06:16PM

    by Anonymous Coward on Saturday April 23 2016, @06:16PM (#336288)

    Smart people might want to use your software. They can figure out what you wrote and what you were thinking. But you shouldn't make them, because reward isn't guaranteed for that effort.

    Instead, 'dumb it down' and make elevator pitches. Can you explain, in HARD CAPPED THIRTY SECONDS, what it does? Refine your description until you can, then use that as your descriptive text. Do the same for any other critical information. Take *important* usage recommendations ('here's how you can structure things!') and decompose using examples (grab any software-skills textbook, eg. a sql one, for the format) so that it's active learning for the reader.

    EVERYTHING which is at present a brain-dump should be recompiled into (using onemodel's format) internal project docs. Get your project docs ducks in a line and keep them out of the user-public eye, and in the git-repo-public eye. Separate your internal project documentation and your user documentation!

    Starting Score:    0  points
    Moderation   +2  
       Insightful=2, Total=2
    Extra 'Insightful' Modifier   0  

    Total Score:   2  
  • (Score: 1) by lcall on Saturday April 23 2016, @06:34PM

    by lcall (4611) on Saturday April 23 2016, @06:34PM (#336294)

    Thanks for your comment (which I upvoted; not sure why it got downvoted before).

    That is hard for me. I can probably do it with long effort, but in a previous job I found that the tech writers could transform my best writing into something much better for a given audience.

    I would value greatly your participation on the om-list to provide ongoing feedback, or so I can ask "is this better..."?:
    https://pairlist6.pair.net/mailman/listinfo/om-list [pair.net]

    (Or of course, this list whose content is a subset of the discussion list:
    https://pairlist10.pair.net/mailman/listinfo/om-announce [pair.net] )

    • (Score: 2) by hendrikboom on Sunday April 24 2016, @12:54PM

      by hendrikboom (1125) Subscriber Badge on Sunday April 24 2016, @12:54PM (#336525) Homepage Journal

      Tech writing is a skill that can be learned. If you were to learn it, you'd probably find that you would require different tools to express yourself after that. You won't get it by getting a machine to write for you.

      As for how to learn it, the only way I know is to do it, and revise mercilessly, getting constructive criticism from readers.

      I used to hate writing. My Phd thesis was an exercise in tears. What turned me around was a good workshop on creative writing, followed by several Novembers of nanowrimo.

      After that, I no longer feared writing lots of text. If something wasn't clear enough, I rewrote, and rewrote again. often from scratch each time, until it was good enough. (no that isn't the recommended approach for the nanowrimo November; then you just write the *first* draft; rewriting later). Now I just emit words roughly on topic and then change them a few times once I've found out what I was writing. Often you only find out what you have to say by saying it wrong.

      -- hendrik