An open-source, federated content repository

New ModeShape documentation

Over the past few years, the ModeShape community has put together a simple Getting Started Guide and a much more comprehensive Reference Guide. Our goal for the latter was that it would be an asset for users when trying to figure out ModeShape’s features, how to configure ModeShape, or how and why ModeShape behaves the way it does. And over the years, the Reference Guide has become harder and harder to organize and maintain.

So we’re happy to announce that we’re moving our two guides to the new system for projects. There’s now just one link to the ModeShape documentation:

There you’ll find documentation for the upcoming 2.7 release (look for it this week!) and the drafts for the 3.0 release (still under heavy development).

The new documentation system is built with Confluence, and we think it is a great improvement over our older DocBook system:

  • Readers can leave comments. So please leave a comment if you find a mistake, have a tip for other readers, or want to clarify something. (We do prefer that you still use our forum to ask questions or report problems.)
  • Corrections can be made immediately. Right now, only contributors can make changes, but please let us know if you’re interested in contributing.
  • Interactive table of contents. The left hand side of the documentation includes a table of contents that you can collapse and expand as needed, and of course every item is a link.
  • Search. Yup, there’s a search field that only searches ModeShape documentation.
  • Next and previous page links to make it easy to keep reading.
  • Version-specific documentation. This is something that the folks have made possible through some clever extensions. When we issue a release, we can copy the documentation for the latest release and create a new set for the upcoming version.
  • Outstanding editor. Not everyone will see this, but the contributors are going to love the rich text editor and the really nice wiki markup editor.

In short, lots of great new features. You’re gonna love it.

One more thing

Since the upcoming 2.7 release contains mostly bug fixes, the content for the 2.7 documentation will be pretty similar to the 2.6 release docs, except for some formatting improvements, clarifications, and other minor changes and fixes.

However, for 3.0 we’re doing a major overhaul on the documentation. We’re completely reorganizing the content and trying to make it just as useful for new users just starting out with ModeShape as it is for those experienced users that just need to find the details of a particular feature or behavior. For example, we’re creating a new section that just talks about how to use the JCR API.

Have a look, and let us know what you think!

Filed under: uncategorized

2 Responses

  1. Hendy Irawan says:

    Congratulations Randall !

    Great job ! đŸ™‚

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

ModeShape is

a lightweight, fast, pluggable, open-source JCR repository that federates and unifies content from multiple systems, including files systems, databases, data grids, other repositories, etc.

Use the JCR API to access the information you already have, or use it like a conventional JCR system (just with more ways to persist your content).

ModeShape used to be 'JBoss DNA'. It's the same project, same community, same license, and same software.



%d bloggers like this: