Articles

The Introduction to MaxWiki

Note: As of April 2017, the Wiki content was transitioned to this main cycling74.com website. If there is content that was on the Wiki originally and you are unable to find it through our website search, email website@cycling74.com.

I am constantly surprised by the work that Max programmers accomplish. Whether creating video projection effects, sensor-based installations, generative compositions or immersive 3-D worlds, the breadth of work produced is amazing. But there is more to the Max community than that – it is also a group of people that are anxious to share the things they learn.

As a company, we’ve worked hard to create the documentation necessary to take advantage of new technologies and new features. But there are limits to the amount of content we can develop, and difficulties in meeting the diverse needs of our users’ interests. As a result, we’ve decided to open up a new avenue for information to be created and disseminated by our employees - and also by our users.

The mechanism that we are using is a Wiki system (MediaWiki, to be precise). This is the backbone behind the Wikipedia online encyclopedia, and represents a flexible and robust way to store information. Everything about a Wiki is flexible; you can modify the organization, contents and presentation of a Wiki without going through any sort of vetting procedures. Thus, a Wiki is perfect for a community that wants to share and is willing to have the content management process be open and transparent.

What makes sense to place within a Wiki? We think it is a great place for all sorts of information: extended reference material, tutorials, discussions of technique and methods for working with hardware. We’ve started the system with a few top-level categories:

  • All About Max: This is the location for information about Max itself. It is a great place for tutorials and curriculum on Max training, but it is also where we’ve placed the extended reference material. Right now, most of these reference pages are placeholders; if you have information about how you use a particular object, this is a great place to share your notes.

  • Max and Technology: Here is where we put information about the technologies that are embedded within Max. Whether we are talking about JavaScript, OpenGL or Max for Live, you should find a section that contains material that will interest you. This is also a great place to share some of your knowledge – it allows you to focus on your favorite technology, share concepts and review other people’s ideas.

  • Max Interfaces: This is where we talk about technologies that exist outside of Max. Hardware information lives here (and we have some placeholders for the Kinect, Lemur and Monome), but this is also a good place for virtual technology interfaces such as DMX and OSC.

  • Topics and Techniques: Have you been using Max long enough to remember the old Topic and Tutorials manual? This was a useful repository for discussion of special features and functions used in Max programming, and also is a good location for Max-wide discoveries. If you want to talk (or read) about concepts larger than a single object, or to talk about operating the Max application, this is your home!

  • People and Places: Are you interested in Max workshops, schools that teach Max or people that can do consulting? Or do you give workshops or teach classes? Look here for information, and feel free to add your own information in this area.

It is the final section that is probably the most important part of the Max Wiki. Labeled “Do you want to write an article?”, this section provides the information you need to edit articles, include web and media links into your article, and interface with the existing categories of the current site format. Entering information into a Wiki is pretty straightforward, but you may want to look in here to make sure you get the best formatting available for your content.

The Wiki couldn’t have come to life without the work of a lot of people. Gregory Taylor, the Wiki Gardener, did a lot of research before selecting the MediaWiki tool, and has led the charge to make it happen. The entire Cycling ’74 web team helped integrate the Wiki into the rest of the site (have you noticed the Wiki tab now available in searches?), and is helping provide support and maintenance for the future.

But more of all, we want to thank you, the users of Max, for your willingness to share. It is this openness that has created an incredible community of media artists and developers.

by Darwin Grosse on December 3, 2012

Creative Commons License
alex's icon

Good idea! I'm finishing a historical reconstruction of max. Now available only in Italian. It can be interesting?

Darwin Grosse's icon

Certainly!

jdmoore's icon

Do you plan to add a section on mxj / mxj~ to the Max and technology section of the Wiki?