Standardized documentation metadata
by Pete Travis
Hi all,
I'm working through the logistics of consuming arbitrary markup
formats. It would be helpful to have a standardized way to describe a
document. The example below is YAML, because it is easy to digest,
write, and read, and I think the structure covers the important
attributes without being cumbersome.
---
title: Example Document
stub: A representation of a document description standard.
abstract: >
This could be an example document.
It could explain example documents.
It could use examples to explain what a document is.
It is none of these.
author:
- Carlton Bentleby
- Vizek Glibensky
- Obvious Pseudonym
taxonomy:
theme: Contributions
scope: Documentation
track: Metadata
project: anerist
tags:
- yaml
- metadata
- proposal
- standard
---
title, stub, and abstract are self-apparent.
Author seems like a MAY item; for a standard to go further than our
group, it'll need that, but staking a line around a collaborative work
MAY discourage collaboration.
The taxonomy can be in any order, but in function it's hierarchical;
theme at a very abstract level, scope being more refined, track gets
down to a specific topic. The project differentiates between different
approaches to addressing a given topic (and hey, people _will_ look for
answers on a specific solution).
Tags give some SEO value, could help crossreferences, site search
features... all that stuff that tags do.
What do you think? How can it be better?
--
-- Pete Travis
- Fedora Docs Project Leader
- 'randomuser' on freenode
- immanetize(a)fedoraproject.org
9 years
Getting back into Docs
by Ryan Lerch
After a few years, i am keen to start helping make Fedora docs!
any thoughts on where to jump in again?
--ryanlerch
9 years
Self Introduction Ashutosh Bhakare
by Ashutosh Bhakare
hi All
I am newcomer to Fedora Project; I am basically Trainer of Linux (VA,
Cloud, JBOSS, Clustering etc) I am RHCA - V
I am eager to work as a intermediate documentation write for the same. I
am having knowledge of Python, Docker, Scripting, IPA, Samba, NFS etc.
Which makes the excellent match for the project.
Looking for approval !!
Kind Regards
Ashutosh S.Bhakare
( RHCA-V, EX436, CL210, EX236, EX413, RHC {JA, SS, VA, E, SA }, MCP,
CCNA)
Unnati Computers,Aurangabad
Red Hat Authorised Training Partner
http://www.unnatiithub.org, http://thinclientworld.com
Ph.9822451920,0240-2485766
9 years
Fedora 22 Beta Release Readiness Meeting :: Thursday, April 09, 19:00 UTC
by Jaroslav Reznik
Fedora 22 Beta Release Readiness Meeting.
date: 2015-04-09 place: irc.freenode.net in #fedora-meeting-2
time: 19:00 UTC (3 PM EDT, 12 noon PDT, 21:00 CEST)
This Thursday, April 09, we will meet to make sure we are coordinated
and ready for the Beta release of Fedora 22 on Tuesday, April 14, 2015.
Please note that this meeting will occur on April 09 even if the
release is delayed at the Go/No-Go meeting on the same day two hours
earlier.
You may received this message several times, but I was asked to open this
meeting to the teams and I'll also hope this will raise awareness and more
team representatives will come to this meeting. This meeting works best
when we have representatives from all of the teams. We also have a badge!
Jaroslav
9 years