Author guidelines - Revision history

Hzwakenberg at 11:32, 3 January 2022

2022-01-03T11:32:06Z

← Older revision		Revision as of 13:32, 3 January 2022
Line 1:		Line 1:
	Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].		Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].

−	We ~~invited~~ everyone to participate in creating and improving Liberty Eiffel documentation on this wiki. Just ask on the [[Get in touch#Mailing list\|mailing list]] [mailto:liberty-eiffel@gnu.org liberty-eiffel@gnu.org] for an account.	+	We invite everyone to participate in creating and improving Liberty Eiffel documentation on this wiki. Just ask on the [[Get in touch#Mailing list\|mailing list]] [mailto:liberty-eiffel@gnu.org liberty-eiffel@gnu.org] for an account.

	So far, we did not yet see the need to set up rules for editing this wiki. Please be fair, friendly and don't use this wiki as a place for advertising or any form of discrimination or publishing any form of illegal content.		So far, we did not yet see the need to set up rules for editing this wiki. Please be fair, friendly and don't use this wiki as a place for advertising or any form of discrimination or publishing any form of illegal content.

Hzwakenberg: lingual corrections

2022-01-03T11:31:02Z

lingual corrections

← Older revision		Revision as of 13:31, 3 January 2022
Line 1:		Line 1:
	Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].		Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].

−	~~Everyone is~~ invited to participate in creating and improving Liberty Eiffel documentation on this wiki. Just ask on the [[Get in touch#Mailing list\|mailing list]] [mailto:liberty-eiffel@gnu.org liberty-eiffel@gnu.org] for an account.	+	We invited everyone to participate in creating and improving Liberty Eiffel documentation on this wiki. Just ask on the [[Get in touch#Mailing list\|mailing list]] [mailto:liberty-eiffel@gnu.org liberty-eiffel@gnu.org] for an account.

−	So far we did not yet see the need to ~~setup~~ rules for editing this wiki. Please be fair, friendly and don't use this wiki as a place for advertising or any form of discrimination or publishing any form of illegal content.	+	So far, we did not yet see the need to set up rules for editing this wiki. Please be fair, friendly and don't use this wiki as a place for advertising or any form of discrimination or publishing any form of illegal content.

−	Also note, that by contributing, you confirm that ~~your~~ ~~changes~~ ~~are~~ ~~released~~ under the GNU Free Documentation ~~License~~ as stated in [[Liberty_Eiffel_Wiki:Copyrights]] and that your contributions are not contrarily copyrighted.	+	Also note, that by contributing, you confirm that you release your changes under the GNU Free Documentation Licence as stated in [[Liberty_Eiffel_Wiki:Copyrights]] and that your contributions are not contrarily copyrighted.

Dkearns: s/LibertyEiffel/Liberty Eiffel/

2016-06-22T01:51:16Z

s/LibertyEiffel/Liberty Eiffel/

← Older revision		Revision as of 03:51, 22 June 2016
Line 1:		Line 1:
	Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].		Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].

−	Everyone is invited to participate in creating and improving ~~LibertyEiffel~~ documentation on this wiki. Just ask on the [[Get in touch#Mailing list\|mailing list]] [mailto:liberty-eiffel@gnu.org liberty-eiffel@gnu.org] for an account.	+	Everyone is invited to participate in creating and improving Liberty Eiffel documentation on this wiki. Just ask on the [[Get in touch#Mailing list\|mailing list]] [mailto:liberty-eiffel@gnu.org liberty-eiffel@gnu.org] for an account.

	So far we did not yet see the need to setup rules for editing this wiki. Please be fair, friendly and don't use this wiki as a place for advertising or any form of discrimination or publishing any form of illegal content.		So far we did not yet see the need to setup rules for editing this wiki. Please be fair, friendly and don't use this wiki as a place for advertising or any form of discrimination or publishing any form of illegal content.

−	Also note, that by contributing, you confirm that your changes are released under the GNU Free Documentation License as stated in [[Liberty_Eiffel_Wiki:Copyrights]] and that your contributions are not contrarily copyrighted.	+	Also note, that by contributing, you confirm that your changes are released under the GNU Free Documentation License as stated in [[Liberty_Eiffel_Wiki:Copyrights]] and that your contributions are not contrarily copyrighted.

Hzwakenberg at 16:03, 8 March 2016

2016-03-08T16:03:21Z

← Older revision		Revision as of 18:03, 8 March 2016
Line 1:		Line 1:
	Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].		Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].

−	Everyone is invited to participate in ~~the~~ ~~creation~~ of ~~the~~ documentation ~~of LibertyEiffel in~~ this wiki. Just ask on the [[Get in touch#Mailing list\|mailing list]] [mailto:liberty-eiffel@gnu.org liberty-eiffel@gnu.org] for an account.	+	Everyone is invited to participate in creating and improving LibertyEiffel documentation on this wiki. Just ask on the [[Get in touch#Mailing list\|mailing list]] [mailto:liberty-eiffel@gnu.org liberty-eiffel@gnu.org] for an account.

	So far we did not yet see the need to setup rules for editing this wiki. Please be fair, friendly and don't use this wiki as a place for advertising or any form of discrimination or publishing any form of illegal content.		So far we did not yet see the need to setup rules for editing this wiki. Please be fair, friendly and don't use this wiki as a place for advertising or any form of discrimination or publishing any form of illegal content.

−	Also note, that by contributing you confirm, that your changes are released under the GNU Free Documentation License as stated in [[Liberty_Eiffel_Wiki:Copyrights]] and that your contributions are not contrarily copyrighted.	+	Also note, that by contributing, you confirm that your changes are released under the GNU Free Documentation License as stated in [[Liberty_Eiffel_Wiki:Copyrights]] and that your contributions are not contrarily copyrighted.

Ramack: added License statement

2014-08-11T20:49:18Z

added License statement

← Older revision		Revision as of 22:49, 11 August 2014
Line 4:		Line 4:

	So far we did not yet see the need to setup rules for editing this wiki. Please be fair, friendly and don't use this wiki as a place for advertising or any form of discrimination or publishing any form of illegal content.		So far we did not yet see the need to setup rules for editing this wiki. Please be fair, friendly and don't use this wiki as a place for advertising or any form of discrimination or publishing any form of illegal content.
		+
		+	Also note, that by contributing you confirm, that your changes are released under the GNU Free Documentation License as stated in [[Liberty_Eiffel_Wiki:Copyrights]] and that your contributions are not contrarily copyrighted.

Ramack: removal of SmartEiffel rules

2014-08-11T20:45:34Z

removal of SmartEiffel rules

← Older revision		Revision as of 22:45, 11 August 2014
Line 3:		Line 3:
	Everyone is invited to participate in the creation of the documentation of LibertyEiffel in this wiki. Just ask on the [[Get in touch#Mailing list\|mailing list]] [mailto:liberty-eiffel@gnu.org liberty-eiffel@gnu.org] for an account.		Everyone is invited to participate in the creation of the documentation of LibertyEiffel in this wiki. Just ask on the [[Get in touch#Mailing list\|mailing list]] [mailto:liberty-eiffel@gnu.org liberty-eiffel@gnu.org] for an account.

		+	So far we did not yet see the need to setup rules for editing this wiki. Please be fair, friendly and don't use this wiki as a place for advertising or any form of discrimination or publishing any form of illegal content.
−	The text below is from SmartEiffel wiki and not up to date.
−	[[Category:Smarteiffel]]
−	<div id="GoalsOfTheSmartEiffelWiki">
−	==Objectives of the SmartEiffel Wiki==
−	</div>
−	Beyond being a place of research, exchange and sharing of information,
−	the principle objective of the [[Main Page\|SmartEiffelWiki]] consists of producing a real book that can be printed, if desired, on paper.
−	The program capable of verifying and then automatically extracting the Grand SmartEiffel Book doesn't exist yet, but if we follow a few conventions and editing rules that will become possible.
−	Of course, the Grand SmartEiffel Book will always be available in electronic form.
−
−	<div id="TopicsOfTheBook">
−	==The topics addressed (and what should be addressed) in the Grand Book==
−	</div>
−	First and foremost, that which concerns Eiffel and SmartEiffel.
−	Without pretending otherwise, it's a matter of promoting Eiffel as well as programming with contracts in Eiffel.
−	And equally it's to educate about Eiffel and to make Eiffel known.
−	All topics tied to Software Engineering are equally welcome in the Grand SmartEiffel Book: testing techniques with Eiffel,
−	program validation with Eiffel, object oriented programming concepts with Eiffel, (etc. with Eiffel).
−
−	If the topic that you wish to address in the Grand SmartEiffel Book doesn't have anything to do with Eiffel, don't be surprised if perchance your article is rejected. You have been warned!
−
−	<div id="AdvicesAndRules">
−
−	==Conventions that we should follow==
−	</div>
−	A certain number of conventions to follow have already been mentioned in the
−	[[FAQ#SmartEiffelWiki\|FAQ of the Grand SmartEiffel Book]].
−	The conventions and rules which follow should be equally respected.
−
−	<div id="TableOfContents">
−	===Place each page in the "Table of contents"===
−	</div>
−	Except for purely interactive pages, the '''vast majority''' of pages should
−	find their place in the "[[Table of contents]]" page.
−	In fact, only the pages referenced in the "[[Table of contents]]" will become part of the printed version of the Grand SmartEiffel Book.
−
−	Of course, a Wiki is by its nature a place of discussion and exchange.
−	Certain pages should therefore be utilized for these interactions and exchanges and should not be included in the Grand SmartEiffel Book.
−	So, the pages of the SmartEiffelWiki will be classified into two categories.
−	The [[:Category:Book\|Book]] category for pages to go into the Grand SmartEiffel Book.
−	The [[:Category:Community\|Community]] category for pages intended, for example,
−	for news, discussions and/or exchanges in progress.
−
−	<div id="PivotIsEnglish">
−	===Using English as the pivot language===
−	</div>
−	Besides [[FAQ#PageNaming\|page names]], it is simpler to always
−	use the same language, and so to use English, for all similar
−	page items like navigation tags.
−	This is a [[#PivotIsEnglish\|good example]] with respect to this
−	rule.
−	We note that following this rule is nearly as important as following
−	the rule for having page names in English.
−	Like page names, navigation tags can also be made part
−	of the URL and so also serve as a means of correspondence between different
−	translations.
−
−	<div id="AvoidExternalLinks">
−
−	===Avoid external links===
−	<div>
−	Bearing in mind that we wish to be able to print the book, it is
−	preferable to limit the use of external links as much as possible.
−	We will use internal links as much as possible.
−
−	<div id="LanguageSync">
−	===Linking between different languages===
−	</div>
−	It's up to you whether we have a translation in your favorite language.
−	Nevertheless, it is desirable to always ensure that a minimum of linkage
−	exists between pages in different languages.
−	Of course, the utility that will be responsible for producing the paper document derived from the on-line Grand SmartEiffel book will be capable of letting us know that, for example, section numbers in the French version aren't in agreement with the section numbers in the English version.
−	Certainly, the utility will be able to warn us of the error, but it would be a day or two (or more) before one of us would get around to making the correction ... manually.
−	It's therefore asked that each of us use without exception the radio buttons that permit going between one language in order to minimize the amount of manual rework needed later.
−
−	<div id="Style">
−
−	===Corrections concerning style===
−	</div>
−	Of course, it is not always necessary to ask the author's permission to correct spelling or an error on a page!
−
−	With regard to changes converning style or the turn of a phrase,
−	we propose to adopt a preference for a style that is relatively neutral and fairly simple, above all as clear as possible, and finally, not too pedantic.
−	Don't lose the point of view that the goal of the Grand SmartEiffel Book is to
−	[[#TopicsOfTheBook\|promote and educate about Eiffel]] and not to be a candidate for the Pulitzer prize.
−
−	Finally, it's good to keep in mind that it's always possible to return later to make style modifications with a few clicks of the mouse.
−	The simplest means to convince an author of the pertinence of a modification often consists of making the change directly in the text.
−
−	To finish, we note that a bit of humor never did anyone any harm.
−	It's up to you to find your own unique writing style.
−
−	<div id="Bibliography">
−
−	===Bibliographical References===
−	</div>
−	The page that contains the
−	[[Bibliography\|bibliographic references]] must be
−	exactly the same for all languages: same number of entries,
−	identical tags, and classification order completely
−	identical.
−	Here is the format that is used in the text of [[Bibliography#ETL 1992\|[ETL 1992]]]
−	for citations.
−
−	<div id="ManualGlossary">
−
−	===The manual index and the glossary===
−	<div>
−	The [[Manual index\|manual index]] as well as the [[Glossary\|glossary]] are understood to be special pages because they are not in the same order when one changes languages.
−	For example, the glossary is put into alphabetical order according to the language of the page; the
−	terms defined are not put into the same order for all languages.
−
−	That being so, like for the other pages, the navigation tags must be common.
−	For example, there must be as many navigation tags in the French glossary as in the English glossary.
−	Like everywhere else, navigation tags are [[#PivotIsEnglish\|always in English]].
−
−	<div id="InCaseOfConflict">
−
−	===In case of any sort of conflict between authors===
−	</div>
−	In the case of multiple authors not being in agreement among themselves as to what should be written, they must continue to discuss among themselves as well as with the entire community in order to arrive at a consensus.
−
−	In the event of an impasse, the SmartEiffel team has the final say as to what decision to make or what to do.
−
−	Finally, if the SmartEiffel team itself cannot come to a consensus,
−	[[Utilisateur:Colnet\|Dominique Colnet]] has the last word.
−
−	<div id="LastWord">
−
−	==Final rule==
−	</div>
−	Don't hesitate to complete or amend these rules and conventions.
−	And above all, '''thanks in advance for your participation''' to the Grand SmartEiffel Book.

Cadrian: liberty-eiffel@gnu.org

2014-07-07T06:31:10Z

liberty-eiffel@gnu.org

← Older revision		Revision as of 08:31, 7 July 2014
Line 1:		Line 1:
	Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].		Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].

−	Everyone is invited to participate in the creation of the documentation of LibertyEiffel in this wiki. Just ask on the [[Get in touch#Mailing list\|mailing list]] [mailto:~~libertyeiffel~~@~~librelist~~.~~com~~ ~~libertyeiffel~~@~~librelist~~.~~com~~] for an account.	+	Everyone is invited to participate in the creation of the documentation of LibertyEiffel in this wiki. Just ask on the [[Get in touch#Mailing list\|mailing list]] [mailto:liberty-eiffel@gnu.org liberty-eiffel@gnu.org] for an account.

	The text below is from SmartEiffel wiki and not up to date.		The text below is from SmartEiffel wiki and not up to date.

Ramack: added not on account creation

2013-03-26T20:22:29Z

added not on account creation

← Older revision		Revision as of 22:22, 26 March 2013
Line 1:		Line 1:
−	[[Category:Smarteiffel]]
	Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].		Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].

−	Everyone ~~can~~ ~~freely~~ participate in the creation of the ~~Grand~~ ~~SmartEiffel~~ ~~Book~~ on ~~the~~ ~~condition~~ ~~that~~ ~~they~~ ~~respect~~ the ~~rules~~ ~~and~~ ~~the~~ ~~objectives~~ ~~presented~~ ~~below~~.	+	Everyone is invited to participate in the creation of the documentation of LibertyEiffel in this wiki. Just ask on the [[Get in touch#Mailing list\|mailing list]] [mailto:libertyeiffel@librelist.com libertyeiffel@librelist.com] for an account.

		+	The text below is from SmartEiffel wiki and not up to date.
		+	[[Category:Smarteiffel]]
	<div id="GoalsOfTheSmartEiffelWiki">		<div id="GoalsOfTheSmartEiffelWiki">
	==Objectives of the SmartEiffel Wiki==		==Objectives of the SmartEiffel Wiki==

Ramack at 21:18, 5 March 2013

2013-03-05T21:18:02Z

← Older revision		Revision as of 23:18, 5 March 2013
Line 1:		Line 1:
−	[[Category:~~SmartEiffel~~]]	+	[[Category:Smarteiffel]]
	Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].		Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].

Ramack at 20:51, 4 March 2013

2013-03-04T20:51:21Z

← Older revision		Revision as of 22:51, 4 March 2013
Line 1:		Line 1:
−	[[Category:~~Book~~]]	+	[[Category:SmartEiffel]]
−	Concise usage guide for contributors to the [[Table of contents\|~~Grand SmartEiffel Book~~]].	+	Concise usage guide for contributors to the [[Table of contents\|LibertyEiffelWiki]].

	Everyone can freely participate in the creation of the Grand SmartEiffel Book on the condition that they respect the rules and the objectives presented below.		Everyone can freely participate in the creation of the Grand SmartEiffel Book on the condition that they respect the rules and the objectives presented below.