The skeleton of this document is the outline we came up with in our meeting in mid-April. Inserted into each section are the notes Abby produced in February, each with a heading with *'s in it. Section authors can use or not use the content of the notes.
People are assigned to sections (or subsections, in some cases) by virtue of their name being in the section title. These are assignments are from the meeting notes from Mar 10, and may have shifted...Just send mail to the gang.
audience considerations ----------------------- CWIS FAQ "Syle Guides" section includes links on both accessibility for the disabled and some device-independent styling stuff: http://web.mit.edu/cwis/publishing.html#style ** Pedagogical ** ***************** We talked a bit about this at our meeting; I'm not sure how much we'd want to take on in the basic doc. phase, but we should include some general verbiage on Things to Think About Throughout. cf. the UWired Catalyst Quick Guides, each of which includes a "Plan" and "Reflect" bit: http://depts.washington.edu/catalyst/quick/ ** Unix/Athena browser capabilities vs. Mac/PC ** ************************************************* General thought: document what works differently on Unix vs. Mac/PC or is unavailable on Athena (e.g., embedded video, shockwave, real players) and conversely, difficult formats for Mac/PC (e.g. postscript).
** Legal/Institute Policy ** **************************** CWIS "Appropriate Use" guidelines http://web.mit.edu/cwis/faq/guidelines.html MIT's Copyright Working Group http://web.mit.edu/copyright/ Student Information Policy (draft) http://tute.mit.edu:8001/policies/proposed/mitmostly/sip.html ** Accessibility ** ******************* W3C Web Accessibility Initiative (distinguish tiers here and in how-to sections -- practical tips, general principles, from broad issues): http://www.w3.org/WAI/ ** Accessibility (practical tips) ** ************************************ (distinguish tiers here -- i.e. practical tips and general principles from broader issues) Some obvious starting points: http://www.w3.org/WAI/ http://trace.wisc.edu/world/web/ http://web.mit.edu/atic/www/otherresources.html#generic
** Basic HTML ** **************** "Electronic Publishing at MIT Using HTML" (TPS) http://web.mit.edu/is/help/html/ CWIS FAQ has basic guidelines and links on html: http://web.mit.edu/guidelines.html#tags as well as various links from Publishing on the WWW: http://web.mit.edu/cwis/publishing.html#creating ** HTML Editors** ***************** (General overview of issues & options?)
** Technical content (e.g. math, chemical eqns.) ** *************************************************** Math ---- Abby's stuff (in progress, will tie-in to article for next Insider): http://web.mit.edu/ajfox/Public/projects/webmath/ CWIS FAQ and Publishing on the WWW pages both point to Reid's: http://web.mit.edu/maple/www/how-to/math-to-web-1.html Last modified 97/10/20 Chem ---- Craig mentioned in a recent weekly rpt: "tried different chemical equation formatting tools. WebEQ and chemdraw are pretty good, but latex and latex2html are highest quality for equations (more symbols available than in WebEQ)."
** Graphics ** ************** CWIS FAQ "Effective Uses of Graphics on the WWW" (general, a bit old): http://web.mit.edu/cwis/faq/graphics.html $Date: 1999/07/20 20:25:58 $ CWIS Publishing on the Web (various outside links): http://web.mit.edu/cwis/publishing.html#graphics ** Multimedia ** **************** General: provide some tie-together, top-level dicsussion as well as pointers to background info. & tech. tips. Be sure to include info. on what can "play" on unix/Athena vs. Mac/PC. CWIS Publishing on the Web includes under Graphics, Sounds, Videos (http://web.mit.edu/cwis/publishing.html#graphics): Multimedia File Formats on the Internet (DOS/Windows) http://www.lib.rochester.edu/multimed/contents.htm MPEG Pointers and Resources http://www.mpeg.org/ QuickTime How-to Guide http://www.apple.com/quicktime/authors/index.html Index to Multimedia Information Sources http://cui_www.unige.ch/OSG/MultimediaInfo/index.html In addition to general considerations that carry over from the FAQ "Effective Uses of Graphics on the WWW": http://web.mit.edu/cwis/faq/graphics.html
** Scanning images ** ********************* General considerations that carry over from CWIS FAQ "Effective Uses of Graphics on the WWW": http://web.mit.edu/cwis/faq/graphics.html $Date: 1999/07/20 20:25:58 $ debby's ref. (Kai's Power Tip #4) on cleaning up scans in Photoshop: http://www.pixelfoundry.com/Tips/KPT4/KPT4.html
** Word proc. docs. ** ********************** (Need info. on conversion options, versions with save-as-html features, etc.) ** PowerPoint slides ** *********************** CWIS FAQ includes "Is there a way to convert PowerPoint slides (or other Postscript files) to Web pages?" which links to info. on webify, no mention of PDF: http://web.mit.edu/cwis/faq/webify.html $Date: 1999/07/20 20:25:58 $ ** Spreadsheets ** ****************** (info. on conversion options)
** PDF ** ********* ACS FAQ (set up more for ref. than as a how-to guide; extract bits?) http://web.mit.edu/acs/www/faq/pdf.html
** Foreign languages ** *********************** (info. on what browsers support?)
** Scanning OCR ** ****************** (Info. on what works and what's problematic, what to split between image and OCR, etc. For scanning both text and images, it'd be great if we could distill for general ref. whatever general tips Katie and the CWIS folks give when doing tutorials.)
** Restricting access ** ************************ Need overview of issues & current options, in addition to CWIS tute page: http://web.mit.edu/cwis/tute/mitmostly2.html
** ereserves ** *************** (What do we want to say about this, if anything?) ** registrar's stuff (URLs in catalog, class rosters, etc.) ** ************************************************************** online catalog & ACS acaduses page (where are we on process discussion with Phoebe et al.?) http://student.mit.edu/@2977600.15640/catalog/help.html#editing class rosters, etc. http://student.mit.edu/webreg.html ** MITIE/CPB ** *************** (General doc. on whatever we have in place, or at least something on working aith course page templates?) ** neo-NEOS ** ************** stuff beyond the common realm, but worth a mention? --------------------------------------------------- - running a web server (http://web.mit.edu/apache-ssl/www/ includes admin. guidelines as well as software & tech info) - databases (what to say about FileMaker, Oracle generally; spec. support for slide/image/dataset archives?) - CGI scripts other than translateform and process-comments - using web pages as software download sites (no for "org" lockers, do we have guidelines more generally?)
feedback/communication features ------------------------------- (Thought here is that it'd be nice to explain how these features relate/contrast and can be used to meet different needs.) - Mailto links - Comment forms/web surveys - Forums - SIPB discuss www gateway (to supplement lack of mail feed in WebX) ** Search engine hits ** ************************ MIT Ultraseek help page http://web.mit.edu/ultraseek/help/ Using Meta Tags at MIT http://web.mit.edu/cwis/faq/metatags.html
** File Transfer ** ******************* ACS notes on secure file transfer http://web.mit.edu/acs/www/faq/remote_access/filetransfer.html CWIS FAQs http://web.mit.edu/cwis/faq/file-transfer.html http://web.mit.edu/cwis/secure-xfer/ Need some info. on using editor "publish" or upload features in our environment. ** Basic Athena stuff for web maint. ** *************************************** ACS notes on remote access http://web.mit.edu/acs/www/faq/remote_access/ CWIS-pub notes on general Athena commands for web pub. http://web.mit.edu/cwis/cwis-pub/9811cwis-pub.html
3. General Training/Support/Production Resources ------------------------------------------------ Overall, we should try to explain the role/scope of each group and how support ties together from a user perspective. ** TPS ** ********* Can't link directly to relevant courses, so explain nav.: http://web.mit.edu/is/training/ --> List of Available Courses (Quick-Starts & Hands-On) --> Web/Internet Graphics/Presentation Current courses are: Web/Internet Home Page Quick Start HTML (HyperText Markup Language) Demo Overview of Purchasing on the Web Quick Start World Wide Web Quick Start Netscape 4: Web Navigation Basics Netscape 4: Web Navigation Intermediate Web Publishing at MIT Graphics/Presentation PowerPoint Quick Start Photoshop 5: Basics PowerPoint: Basics Photoshop 5: Update PowerPoint: Intermediate Photoshop 5: Advanced