online-documentation: to differ better versions, to view faster the right content

classic Classic list List threaded Threaded
2 messages Options
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

online-documentation: to differ better versions, to view faster the right content

Klaus Lehmann
hi demian

my problem mostly, is to recognize, to view, to understand,
"WHAT DO I SEE?"
more precisely: the information, I do read, for what version is it?

my thesis: vufind is developed in !mainly! THREE different versions
I say: no hint or advice, formulated for V1.x, is (mostly)
unaczeptable for V2.x or V3.x, and vice versa.

therefor an idea:

please create 3 symbols, like V1, V2 or V3
[sorry, from my historical knowledge, I don't want to use "V2"; I
remember my time in southern england, visiting a castle, speaking with
a real EARL, I was using the word "blitz". don't knowing, that "flash"
was more lovlier, has more "political correctness"....] [its offtopic
young (sic) boys!]

and THAN mark all lines, or all abstracts(?) or paragraphs with one,
two or not impossible with theree symbols.

the positive effect, we can see VERY fast, is this information "good
for me".

yes?
it's only an idea.....

yours klaus







--
Mit freundlichen Grüßen,
Ihr Klaus Lehmann
http://allegronet.de * eMail: [hidden email] * phone: 03528-452 807(fax 809) * mobil: 0171-953 7843
allegronet.de * Klaus Lehmann * D-01454 Radeberg * Bahnhofstr. 1
zuständiges Finanzamt: FA Hoyerswerda; zuständige Kammer: IHK Dresden;
zuständige Aufsichtsbehörde: Gewerbeamt Radeberg; USt-IdNr: DE247550760
Für den schnellen Geldverkehr: http://PayPal.Me/LehmannKlaus
* Software für zufriedene Bibliothekare: 1000x bewaehrt und ergiebig
* Bereits 4x allegro-utf8. Buchen Sie die allegro-Roadshow. Yes we can!
* Internetkataloge & WebHosting für Allegro-C & Web 2.0 mit VuFind
* 2011: Sponsor der Peter-Sodann-Bibliothek (Staucha)
* 2013-2016: Bolero 64bit+allegro-zdb+eBooks-allegro-imd
* 2017: allegro-zdb-direkt
Seit 2015 Spezialist in real Big Data! Beispiele: allegro-zdb&allegro-imd
Warum funktioniert mein ZACK-Zugriff nicht mehr? Fragen über Fragen
Lesen Sie auf http://portal.allegronet.de/allegrowerkstatt/allegro-windows .


------------------------------------------------------------------------------
Announcing the Oxford Dictionaries API! The API offers world-renowned
dictionary content that is easy and intuitive to access. Sign up for an
account today to start using our lexical data to power your apps and
projects. Get started today and enter our developer competition.
http://sdm.link/oxford
_______________________________________________
VuFind-General mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/vufind-general
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: online-documentation: to differ better versions, to view faster the right content

Demian Katz
Klaus,

It's not quite so simple as V1, V2 and V3. It's more like "V1" and "everything else." When we released 2.0, it was a total rewrite with very little in common with 1.x. Since then, some things have changed, but only in a more incremental way. Thus, most of the 1.x documentation is completely out of date, but the rest of the documentation is fairly universal, though sometimes having notes about certain details that were introduced or phased out in later versions.

You'll notice that some web pages live inside a "legacy" namespace. If you see "legacy" in the URL, it's old 1.x documentation and should be ignored. All of these documents should have a :!: note at the top indicating that they are outdated and linking to the more current equivalent.

We also try to use :!: (which creates a very visible exclamation point icon in the rendered wiki page) on any parts of the documentation that may differ from version to version.

I do like your idea of having more specific icons for certain types of notes, and perhaps more clearly differentiating the versions. We can certainly do that to highlight the 1.x pages... but it's not going to be quite that easy with 2.x, 3.x and the upcoming 4.x....

Anyway, I'll keep giving this some thought and see if we can improve the situation.

thanks,
Demian

-----Original Message-----
From: Klaus Lehmann [mailto:[hidden email]]
Sent: Tuesday, March 07, 2017 12:56 PM
To: [hidden email]
Subject: [VuFind-General] online-documentation: to differ better versions, to view faster the right content

hi demian

my problem mostly, is to recognize, to view, to understand, "WHAT DO I SEE?"
more precisely: the information, I do read, for what version is it?

my thesis: vufind is developed in !mainly! THREE different versions I say: no hint or advice, formulated for V1.x, is (mostly) unaczeptable for V2.x or V3.x, and vice versa.

therefor an idea:

please create 3 symbols, like V1, V2 or V3 [sorry, from my historical knowledge, I don't want to use "V2"; I remember my time in southern england, visiting a castle, speaking with a real EARL, I was using the word "blitz". don't knowing, that "flash"
was more lovlier, has more "political correctness"....] [its offtopic young (sic) boys!]

and THAN mark all lines, or all abstracts(?) or paragraphs with one, two or not impossible with theree symbols.

the positive effect, we can see VERY fast, is this information "good for me".

yes?
it's only an idea.....

yours klaus







--
Mit freundlichen Grüßen,
Ihr Klaus Lehmann
https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fallegronet.de&data=02%7C01%7Cdemian.katz%40villanova.edu%7C4337dc8edfa048caa8b808d465837403%7C765a8de5cf9444f09cafae5bf8cfa366%7C1%7C0%7C636245062640287600&sdata=roTbhVEQwZ3eaFBGdTQkFNuRIIlORclV7V700BvrFAA%3D&reserved=0 * eMail: [hidden email] * phone: 03528-452 807(fax 809) * mobil: 0171-953 7843 allegronet.de * Klaus Lehmann * D-01454 Radeberg * Bahnhofstr. 1 zuständiges Finanzamt: FA Hoyerswerda; zuständige Kammer: IHK Dresden; zuständige Aufsichtsbehörde: Gewerbeamt Radeberg; USt-IdNr: DE247550760 Für den schnellen Geldverkehr: https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2FPayPal.Me%2FLehmannKlaus&data=02%7C01%7Cdemian.katz%40villanova.edu%7C4337dc8edfa048caa8b808d465837403%7C765a8de5cf9444f09cafae5bf8cfa366%7C1%7C0%7C636245062640287600&sdata=qi4D8558mz44FfgvegUBfpfsk3K5S6UNBLuq4MqegZk%3D&reserved=0
* Software für zufriedene Bibliothekare: 1000x bewaehrt und ergiebig
* Bereits 4x allegro-utf8. Buchen Sie die allegro-Roadshow. Yes we can!
* Internetkataloge & WebHosting für Allegro-C & Web 2.0 mit VuFind
* 2011: Sponsor der Peter-Sodann-Bibliothek (Staucha)
* 2013-2016: Bolero 64bit+allegro-zdb+eBooks-allegro-imd
* 2017: allegro-zdb-direkt
Seit 2015 Spezialist in real Big Data! Beispiele: allegro-zdb&allegro-imd Warum funktioniert mein ZACK-Zugriff nicht mehr? Fragen über Fragen Lesen Sie auf https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fportal.allegronet.de%2Fallegrowerkstatt%2Fallegro-windows&data=02%7C01%7Cdemian.katz%40villanova.edu%7C4337dc8edfa048caa8b808d465837403%7C765a8de5cf9444f09cafae5bf8cfa366%7C1%7C0%7C636245062640287600&sdata=CefwRHXUpLMOaOyfuXBVWY67nA2zkaSq%2Fnx9sHhT6g4%3D&reserved=0 .


------------------------------------------------------------------------------
Announcing the Oxford Dictionaries API! The API offers world-renowned
dictionary content that is easy and intuitive to access. Sign up for an
account today to start using our lexical data to power your apps and
projects. Get started today and enter our developer competition.
https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fsdm.link%2Foxford&data=02%7C01%7Cdemian.katz%40villanova.edu%7C4337dc8edfa048caa8b808d465837403%7C765a8de5cf9444f09cafae5bf8cfa366%7C1%7C0%7C636245062640287600&sdata=DCVcjFZWEuNsbqA2%2BRSj8DigeJmMuV7QJIcQYUJGhPw%3D&reserved=0
_______________________________________________
VuFind-General mailing list
[hidden email]
https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Flists.sourceforge.net%2Flists%2Flistinfo%2Fvufind-general&data=02%7C01%7Cdemian.katz%40villanova.edu%7C4337dc8edfa048caa8b808d465837403%7C765a8de5cf9444f09cafae5bf8cfa366%7C1%7C0%7C636245062640287600&sdata=EDeoJ3Whz5L0PlMpC6GjO0aM6mZD8WvCSEGz7FuIKmY%3D&reserved=0

------------------------------------------------------------------------------
Announcing the Oxford Dictionaries API! The API offers world-renowned
dictionary content that is easy and intuitive to access. Sign up for an
account today to start using our lexical data to power your apps and
projects. Get started today and enter our developer competition.
http://sdm.link/oxford
_______________________________________________
VuFind-General mailing list
[hidden email]
https://lists.sourceforge.net/lists/listinfo/vufind-general
Loading...