User Tools

Site Tools


contribution_guidelines

NIMWiki Contribution Guidelines

These are some very general guidelines for contributing to NIMWiki, in no particular order.

There's a mailing list (a mailing list, not a web forum) for internal discussion and coordination of materials, presentation, etc. All contributors are welcome to subscribe to the list and participate. Information (and diffs) for any edits made to NIMWiki are automatically sent to the list as well. Participation in the mailing list is optional for NIMWiki contributors, but it will probably be useful, and therefore is recommended. To subscribe, either point a web browser at https://lists.neurotica.com/ and register, or send email to mcguire@mcguirescientificservices.com and I will add you.

The NIMWiki site is managed by a Wiki-style content management system called DokuWiki. It is a fast, lightweight CMS with a good feature set. Its markup language is simple and easy to learn. It is documented here.

Please do not use externally-hosted images, in particular on image hosting services. Historically, these services, subject to corporate whim, have a way of just disappearing without warning and taking all of their users' photos with them. Upload local copies here.

The purpose of NIMWiki is to make available practical, generally useful information about NIM, CAMAC, and FASTBUS instruments and systems. Quick at-a-glance facts, “action shots”, historical information, common repair/maintenance requirements, and things of that nature.

←- The main page should have only links for instruments which have pages, while the model number index, linked from the main page, should contain all model numbers and names for everything we can find, whether there's an instrument page for it or not. We will add links to instrument pages on the main page only after the new pages are created. –>

Please use proper, formal abbreviations for units. For example, Hz, kHz, MHz, and GHz are correct, while khz, mhz, Ghz, etc are not. Further, please be precise in terms of grammar, sentence structure, and things like that. This will help with trust and credibility. This is intended to be a professional-quality effort.

When you click on an instrument link, it will take you to a blank page telling you that it doesn't exist. Use the “create this page” link on the right, which will put you into an editor that's pre-populated with a layout template. Edit as appropriate.

As the site administrator, I (Dave McGuire) may occasionally make edits, or suggestions for edits, for matters of clarity and/or consistency. Please do not take any offense if this occurs; there is never any intention of disrespect. My feeling is that, to be a useful resource, NIMWiki must be easy to use, and consistency of presentation is where that begins.

contribution_guidelines.txt · Last modified: 2022/01/17 18:49 (external edit)

Page Tools