search

altoxml / board

ALTO board meeting minutes, agendas, and miscellaneous business
1 stars 2 forks source link

Make a better and easy to maintain "http://altoxml.github.io" #25

Closed evelienket closed 8 years ago

cneud commented 8 years ago

Hello everyone, I've made a draft of a simple front page (attached - please save and rename to .html to view in a browser - GitHub don't allow html files as attachments): index.html.txt.

Feedback welcome!

Jo-CCS commented 8 years ago

Hi Clemens, very nice - I like it. I would just propose to change sequence and to put those of general interest to top, means to place “ALTO Board Meeting Agenda and Minutes” at the end. Also the other two elemens I would expand by default until having more than 3 sub-elements. Attached the adapted result. Jo index_adaptedJo.html.txt

cowboyMontana commented 8 years ago

Hello Clemens and Jo, Looks good to me too. Suggest you replace the current index.html with either Clemens' original version or Jo's revised version. And then close this issue. Frederick

cneud commented 8 years ago

I second the order of bullet points as proposed by Jo. Some further explanatory text and links may also still be added to the proposed new index.html - I am happy to collect suggestions and revise accordingly.

One further change I would propose in this regard is to make a new branch "gh-pages" in the board repository and move the html files for the meeting agenda and minutes there (similarly to what I did in documentation). This way we end up with - imho - cleaner URLs as e.g. http://altoxml.github.io/board/agenda/... and http://altoxml.github.io/board/minutes/... compared to having everything reside under http://altoxml.github.io/...

I can apply this suggestion once the board agrees.

evelienket commented 8 years ago

Because the github.io page for ALTO is a page that is indexed by search engines I would suggest to add a bit more introduction/explanation to this page like the following:

Welcome to the ALTO XML Github pages ALTO (Analyzed Layout and Text Object) is a XML Schema that details technical metadata for describing the layout and content of physical text resources, such as pages of a book or a newspaper. It most commonly serves as an extension schema used within the Metadata Encoding and Transmission Schema (METS) administrative metadata section. However, ALTO instances can also exist as a standalone document used independently of METS.

The official page of this standard is http://loc.gov/standards/alto. There you will find

"ALTO XML Github” (https://github.com/altoxml) is used as the environment for maintenance and development of the standard. On this location you will find

Jo-CCS commented 8 years ago

Makes sense to me. I agree.

From: Clemens Neudecker [mailto:notifications@github.com] Sent: Mittwoch, 20. Januar 2016 15:45 To: altoxml/board board@noreply.github.com Cc: Joachim Bauer J.Bauer@content-conversion.com Subject: Re: [board] Make a better and easy to maintain "http://altoxml.github.io" (#25)

I second the order of bullet points as proposed by Jo. Some further explanatory text and links may also still be added to the proposed new index.html - I am happy to collect suggestions and revise accordingly.

One further change I would propose in this regard is to make a new branch "gh-pages" in the boardhttps://github.com/altoxml/board repository and move the html files for the meeting agenda and minutes there (similarly to what I did in documentationhttps://github.com/altoxml/documentation/tree/gh-pages). This way we end up with - imho - cleaner URLs as e.g. http://altoxml.github.io/board/agenda/... and http://altoxml.github.io/board/minutes/... compared to having everything reside under http://altoxml.github.io/...

I can apply this suggestion once the board agrees.

— Reply to this email directly or view it on GitHubhttps://github.com/altoxml/board/issues/25#issuecomment-173224755.

cneud commented 8 years ago

Thank you both! I think the text from Evelien fits perfectly, I will update the draft index.html with all your suggestions so far.

cneud commented 8 years ago

Please find attached a revised version of the index.html with all the suggestions applied. index.html.txt

cneud commented 8 years ago

Screenshot of above index.html

screenshot

cneud commented 8 years ago

Updated with new logo. index.html.txt

screen

cowboyMontana commented 8 years ago

Nice!

cneud commented 8 years ago

Revised again following the latest updates to logo+design.

index.html.txt

alto-gh

cneud commented 8 years ago

I would now propose to exchange the current index.html at https://github.com/altoxml/altoxml.github.io with this one above, making this the https://altoxml.github.io landing page. This will require some changes (I am happy to make these adjustments if everyone agrees):

Jo-CCS commented 8 years ago

So definately an agreement from my side, yes. This looks good. Details about the content can be adapted later on, I think. E.g. I would consider to have the linking to the schema releases and changes as extra topic at the beginning of the list as this is the core point.

cowboyMontana commented 8 years ago

looks good Clemens!