From owner-freebsd-doc Mon Jul 23 12:31:50 2001 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (unknown [205.230.22.188]) by hub.freebsd.org (Postfix) with ESMTP id 414D537B407 for ; Mon, 23 Jul 2001 12:31:46 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.3/8.11.3) id f6NJUrV05283 for doc@freebsd.org; Mon, 23 Jul 2001 20:30:53 +0100 (BST) (envelope-from nik) Date: Mon, 23 Jul 2001 20:30:41 +0100 From: Nik Clayton To: doc@freebsd.org Subject: Introducing OMF Message-ID: <20010723203041.A806@canyon.nothing-going-on.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="ibTvN161/egqYuK8" Content-Disposition: inline User-Agent: Mutt/1.2.5i Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org --ibTvN161/egqYuK8 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable One of the things that was discussed at the O'Reilly Documentation Summit yesterday was the use of the Open Source Metadata Framework (OMF) for categorising and cataloging documentation. More information about OMF at http://www.ibiblio.org/osrt/omf/index.html http://www.ibiblio.org/osrt/omf/faq.html It seems that the other documentation projects are in favour of adopting this standard for categorising their documentation, and projects are springing up to present this information to the user in a useful format. For example, scrollkeeper, http://sourceforge.net/projects/scrollkeeper/ which is also available as ports/textproc/scrollkeeper. So I've started thinking about how to use OMF within the FreeBSD docs. It seems like the simplest approach would be add a new file to each document directory, called something like 'omf.xml', containing the metadata for that document. This file might be maintained by hand, or (some of it) might be automatically generated from our DocBook source -- this is because there are also moves afoot to make sure that the OMF metadata set is available inside the *info DocBook elements. Anyone else fancy looking at this in more detail before I get to it? N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ FreeBSD Documentation Project http://www.freebsd.org/docproj/ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- --ibTvN161/egqYuK8 Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjtce2AACgkQk6gHZCw343VwUACfagovwT1tKFnORPRbLbSzDTtJ XnEAnj3BlavoITwmMBzc/tX0WffNY4v3 =MSlf -----END PGP SIGNATURE----- --ibTvN161/egqYuK8-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message