Help:For First Time Contributors: Difference between revisions

From ETHW
No edit summary
No edit summary
 
(19 intermediate revisions by 3 users not shown)
Line 1: Line 1:
== Instructions First Time Users ==
== Instructions First Time Contributors ==


This page is intended to provide information on who can contribute to the Global History Network and what kind of content can be added to the site.
This page is intended to provide information on who can contribute to the Engineering and Technology History Wiki and what kind of content can be added to the site.  


== What is the Global History Network?  ==
== What is the Engineering and Technology History Wiki?  ==


<p>The IEEE Global History Network (GHN) is a website dedicated to preserving and promoting the history of innovation in the history of electrical, electronic, and computer technologies and allied disciplines. The wiki-based site is designed for the public to browse and for IEEE members from around the world to populate it with their experience, knowledge, and insights. The IEEE GHN will also invite professional historians to share their interpretations of the processes of technological change and innovation. In time, the site will serve as a central historical repository of all the achievements, ideas, and first-hand knowledge of IEEE members, societies, councils and technical communities. It also will also provide a central location for all materials related to IEEE’s organizational history. </p>
The ETHW is a website dedicated to preserving and promoting the history of innovation in the history of electrical, electronic, and computer technologies and allied disciplines. The wiki-based site is designed for the public to browse and populate it with their experience, knowledge, and insights. The ETHW will also invite professional historians to share their interpretations of the processes of technological change and innovation. In time, the site will serve as a central historical repository of all the achievements, ideas, and first-hand knowledge of engineering society members, societies, councils and technical communities. It also will also provide a central location for all materials related to engineering’s organizational history.  


== What Can You Share?  ==
== What Can You Share?  ==


<p>The IEEE Global History Network has made it easy for IEEE members to contribute their knowledge and memories on just about any topic. Simply log into the site using your IEEE membership user ID and password, and you’ll be able to review and edit existing content, and add topic threads not yet available. You can upload photos, drawings, diagrams, documents (in both word and PDF format), and video and audio recordings. The idea of the site is to serve as a living electronic memory of all the important contributions made by IEEE members and others to technological progress -- all around the globe. The site will never be complete -- it will continually grow and expand to be a central site for members and others to explore the history of technological innovation. </p>
The ETHW has made it easy for people to contribute their knowledge and memories on just about any topic. [[Special:RequestAccount|Create a user ID and password]], and you’ll be able to review and edit existing content, and add topic threads not yet available. You can upload photos, drawings, diagrams, documents (in both word and PDF format), and video and audio recordings. The idea of the site is to serve as a living electronic memory of all the important contributions made by people to technological progress -- all around the globe. The site will never be complete -- it will continually grow and expand to be a central site for members and others to explore the history of technological innovation.  


== Who Can Contribute and Edit Content?  ==
== Who Can Contribute and Edit Content?  ==


<p>IEEE members can register on the IEEE GHN website using their IEEE member web account user name and password. Simply log into the site using your IEEE membership user ID and password, and you’ll be able to tell your own story in your own words, while enhancing it with photos, drawings, diagrams, documents (in both word and PDF format), and video and audio recordings. Non-IEEE members can apply for non-member access by sending a request to '''ieeeghn@ieee.org''' or by clicking on the "Request Guest Account" link. Once registered as a user, individuals can contribute articles and First-hand Histories. They also can edit unprotected content. </p>
Anyone can register on the ETHW creating a account using the [[Special:RequestAccount|account creation form]]. Simply log into the site using your ETHW membership user ID and password, and you’ll be able to tell your own story in your own words, while enhancing it with photos, drawings, diagrams, documents (in both word and PDF format), and video and audio recordings. [https://ethw.org/Create Create Content form]


== Who Can Participate in Discussions?  ==
== Who Can Participate in Discussions?  ==


<p>Any user (IEEE Member or not) is invited to participate in discussions. You do not have to be logged-in to participate in discussions. </p>
Any user is invited to participate in discussions. You do not have to be logged-in to participate in discussions.  


== The Historical and Technological Scope of the IEEE GHN ==
== The Historical and Technological Scope of the ETHW ==


<p>The registered users of the IEEE GHN, who are IEEE members and historians, will ultimately determine the historical breadths and depth of the site by their writing and editing. The admissible range of technologies for historical presentation within the IEEE GHN is very wide – anything that involves electricity, electronics, and information processing. Examples, to mention just a few, range from microelectronics, giant electric power stations, bio-medical applications, the internet, space travel, ocean engineering, geosciences, video games, to music and movies. </p>
The admissible range of technologies for historical presentation within the ETHW is very wide – anything that involves the history engineering and technology broadly construed. Examples, to mention just a few, range from bridges, microelectronics, oil wells, giant electric power stations, steam engines, bio-medical applications, the internet, space travel, ocean engineering, geosciences, video games, to music and movies.  


<p>Because of the preservation function of the IEEE GHN and the fact that it is a repository of data for future historians, general articles and first-person accounts are allowed to cover right up until today. Certain other sections will be restricted to people, events and innovations that have occurred at least 25 years ago, including the ''IEEE Milestones ''program. Historians have developed various guidelines for how long ago an event must have occurred to be considered ‘historical’, as such certain archival functions may be restricted to conform with such guidelines. </p>
Because of the preservation function of the ETHW and the fact that it is a repository of data for future historians, general articles and first-person accounts are allowed to cover right up until today. Certain other sections will be restricted to people, events and innovations that have occurred at least 25 years ago, including the ''IEEE Milestones ''program. Historians have developed various guidelines for how long ago an event must have occurred to be considered ‘historical’, as such certain archival functions may be restricted to conform with such guidelines.  


== Browser Selection  ==
== Content areas ==


<p>Any browser will work, although we do recommend using the most recent version of whichever browser you use.&nbsp; You can use&nbsp;[http://www.microsoft.com/windows/products/winfamily/ie/default.mspx Internet Explorer],&nbsp;[http://www.mozilla.com/en-US/firefox/ Firefox], [http://www.apple.com/safari/ Safari], [http://www.opera.com/download/ Opera]&nbsp;or [http://www.google.com/chrome Chrome]. You may also&nbsp;need to&nbsp;download a plug-in to run flash animation. You will be prompted to do so when the new browser loads. </p>
[https://ethw.org/Create Create Content form]
 
== Contribution Step One - Logging In  ==
 
<p>We appreciate you participating in the testing phase of the IEEE Global History Network. You'll first need to log in to be able to add or edit content on the GHN. Simply enter your IEEE Web Account username and password in the box on the main page. </p>
 
<p>If the the system has trouble recognizing your login info, then please register by placing your cursor on the word "Register" at the top of the window.</p>
 
<p>In the boxes for username and password, enter your IEEE Web Account info. </p>
 
<p>Once logged in, a box will be available to you through which you can review prior content added by you, and other data. See sample box below. </p>
 
== Content Areas  ==
 
<p>There are several areas of the site for which you can contribute content:Topic Articles and First-Hand Accounts<br> </p>


=== First Hand Accounts  ===
=== First Hand Accounts  ===


<p>Engineers, scientists and related professionals have long been the main actors in the drama of technological innovation. Knowing their stories is essential to understanding how and why technology has progressed as it has for the benefit of humanity. A first-hand account is written in the first person, using the pronouns “I” and “we.” A first-hand account is the recollection of an event, as seen through one person’s eyes. </p>
Engineers, scientists and related professionals have long been the main actors in the drama of technological innovation. Knowing their stories is essential to understanding how and why technology has progressed as it has for the benefit of humanity. A first-hand account is written in the first person, using the pronouns “I” and “we.” A first-hand account is the recollection of an event, as seen through one person’s eyes.  
 
<p>First-hand accounts are very important to understanding the history of technology because they provide the experiences of those directly involved in the acts of discovery, design, invention, R&amp;D, testing, production, and all other the elements shape the process of technological change. First-hand experiences are the accounts of the "actors" themselves. First-hand experiences need not be confined to products and services you worked on or used, they can also refer to your broader development as an engineer; your training and education, your professional affiliations In short, in First-Hand Accounts, you can write about anything that flowed from your work as an engineer and scientist or shaped your development as an engineer or scientist. </p>
 
<p>We encourage you to add your first hand accounts to the GHN. To do this, select the First Hand Histories button on any page. </p>
 
<p>On the main page you'll find a box similar to the one below.&nbsp; The second box allows you to search for other First-Hand&nbsp; Accounts. The first box however, is where you will place the title of your account. You must enter a title. A good title is always important. </p>
 
<p>You'll see a edit box with a toolbar above it. In the box is the sentence "Article content goes here...". Delete these words and then copy and paste your text....or just type right into the box. For more than a few sentences it is better to prepare the text in word processor and then copy &amp; paste it in. In the example below, a new first hand history is being started called "Going to the moon." </p>
 
<p>[[Image:Moon.jpg|700px]]<br> </p>
 
<p>When you want to see a preview of your article, click on "show preview." Once you are happy with you new article, or edits, click on "save page."&nbsp; </p>
 
<p>[[Image:Save.jpg|Image:Save.jpg]]<br> </p>
 
<p>Remember to always "Save page" before naviagating away from the edit box. If you don't, your work will be lost. Because this is your personal experience, you entry cannot be edited by others. Only you can come back to edit or add to it. But there is a Discussion tab. Anyone can comment on your work. The IEEE GHN supports threaded discussions on any entry. We encourage all testers to share their views on any article. </p>
 
<p>Of course, we realize that some first hand histories may be developed by a group of people. Soon, you'll be able to indicate what group of people can add to, or edit a "shared" history. For the testing phase, please email us at ieeeghn@ieee.org to set up a group access to a new article you add. </p>
 
<p>[[Image:Savepage.gif|Image:Savepage.gif]] </p>
 
=== Topic Articles  ===
 
<p>A “topic article” is a third person description of a person, place, event, thing, or idea. The "topic article" requires a balanced exposition that makes reference to all the different credible perspectives. Authors of "topic articles" must cite the sources of the information used in their writing. All the registered users of the IEEE GHN can collaborate on any "Topic Article". Everyones contributions, from the person who first creates the Topic Article to all those who add or edit it, is recorded. The "History" reveals the history of all edits. Any given version of a Topic Article can be found, compared ot other versions, and restored if necessary. Topic articles do not belong to anyone person. They represent the collective insights of many. You may also wish to add new Topic Article, or contribute to existing Topic Articles on the GHN. Please remember, although the subject matter of Topic Articles covers all of IEEE technologies, they all must have something to do with the history of technology. If there are areas in which you have particular interest, your contributions will be appreciated. </p>
 
<p>To add a topic, click on the "Topics" button at the top: </p>
 
<p>[[Image:Topicsbutton.jpg|Image:Topicsbutton.jpg]]<br> </p>
 
<p>Then, on the lower left column, in the box where it is written "Enter Article Title ..."&nbsp; type in the title of your new page. Again, every contribution must have a title. </p>
 
<p>[[Image:Title.jpg|Image:Title.jpg]]<br> </p>
 
<p>For this example, we're creating a page called "x-rays." The following is a sample screen of what you would see next. </p>
 
<p>[[Image:Xray.jpg|700px]]<br> </p>
 
<p>Once again, you should cut-and-paste text from your word processor just about any file (word, text, etc.) into the box over the words "Article Content Goes Here..." The website will automatically adjust your fonts and styles to match those of the site. </p>
 
<p>[[Image:Savepage.gif|715px]]<br> </p>
 
== Adding Headings in Articles  ==
 
<p>Dividing up the content of your article, whether it be a "First-Hand Account" or "Topic Article" into sections with headers will make it more readable to the user. It will also provide an outline view to help with navigation. For a very long article you can even create sections inside sections. The IEEE GHN will also automatically create a table of contents based on the headers that you create. To make a header, type in the section title, highlight it, and then chose one of the header levels in format box in the toolbar. Since Header 1 is reserved for the title of your article, use Header 2, Header 3, or others. &nbsp;See image below. </p>
 
<p>[[Image:Headers.gif|Image:Headers.gif]] </p>
 
== Adding Photos  ==
 
<p>If you have images which might illustrate the content you are providing, these can be uploaded to the site as well. See below, for the procedure for uploading. Once uploaded, go back into the Edit mode. In the toolbar, you'll see atje Insert icon. Arrow is pointing to it inthe image below.&nbsp; </p>
 
<p>[[Image:Addphotos.jpg|Image:Addphotos.jpg]]<br> </p>
 
<p>Photos on the web work best in JPG format. Gif files can also work. If you are planning to contribute a photograph that is in a different format, please "save as" a .jpg in your photo or graphic editing software before uploading.<br> </p>
 
<p><br> </p>
 
<p>Place the cursor where you want the photo go and then hit the Insert icon. A dialog box will appear asking for the name of the image. This name is the one that you created during the upload. As you enter the name of the image, a list of possible matches will appear. When you see yours, click on it. It is also highly recommended that you insert the image as a thumbnail. The dialog box also a gives you the option of placing the image at left, center, or right on the page. </p>
 
<p><br> </p>
 
<p>If you need to add a caption, do so in the box, and be sure to select file type "thumbnail" so your photo caption will show. See below:<br> </p>
 
<p>[[Image:Improp.gif|This is an example of what a photo caption will look like.]] </p>
 
<p>When you are ready to insert yoru photo, just press "OK." </p>
 
<p>[[Image:Savepage.gif|Image:Savepage.gif]] </p>
 
<p><br> </p>
 
== Adding Videos  ==
 
<p>You may&nbsp;upload&nbsp;videos related to your content that are in FLV (Flash VIdeo) format.&nbsp;&nbsp;You may need to convert your current video to&nbsp;a FLV file. For&nbsp;assistance in conversion,&nbsp;Adobe offers [http://www.adobe.com/devnet/video/ online guidance].&nbsp; When creating or converting video files for use on the GHN we recommend the following settings:&nbsp;We recommend the following FLV encoding settings: </p>
 
<p>Flash version: Flash 8 </p>
 
<p>Video Codec: On2 VP6 </p>
 
<p>Video data rate: 400kbps </p>
 
<p>Audio Codec: MP3 </p>
 
<p>Audio data rate: 96kps<br> </p>
 
<p>Once you have created your FLV file, you'll need to upload it to the GHN.&nbsp;We have a limit&nbsp;of&nbsp;a 10MB file size, so you may wish to edit&nbsp;your video if it&nbsp;is larger than 10MB. &nbsp;[http://www.ieeeghn.org/wiki/index.php/Special:Upload Click here] to go to the page to upload a file.&nbsp; You'll see a screen like the one below: </p>
 
<p>[[Image:Addvideo.jpg|Image:Addvideo.jpg]]&nbsp; </p>
 
<p>Click on the browse button and identify the FLV file you wish to upload to the GHN.&nbsp;You may rename the file if you like for use on the GHN at this point.&nbsp; Once the file is uploaded you'll need to insert it into the article you are editing.&nbsp; So, for example, if you were writing an article about antennas, you would next re-open the antenna article, and put your curser at the point in the article you would like the video to appear.&nbsp; Then select the "special tag" icon: </p>
 
<p>[[Image:Specialtag.jpg|Image:Specialtag.jpg]] </p>
 
<p>A drop down menu will appear.&nbsp; Select&nbsp;'flvplayer' from the 'Current Special Tag' pull down list.&nbsp; </p>
 
<p>[[Image:Flashtag.jpg|Image:Flashtag.jpg]] </p>
 
<p>You will then need to enter information in the following format in the 'Special tag parameters' field:<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; VideoName.flv|width|height<br>For example:&nbsp;Hoff640x480.flv|640|480 </p>
 
<p>Note: If you prefer to use Wikitext, you may use the following syntax: </p>


<p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;flvplayer width="640" height="480"&gt;Hoff640x480.flv&lt;/flvplayer&gt;<br> </p>
First-hand accounts are very important to understanding the history of technology because they provide the experiences of those directly involved in the acts of discovery, design, invention, R&amp;D, testing, production, and all other the elements shape the process of technological change. First-hand experiences are the accounts of the "actors" themselves. First-hand experiences need not be confined to products and services you worked on or used, they can also refer to your broader development as an engineer; your training and education, your professional affiliations In short, in First-Hand Accounts, you can write about anything that flowed from your work as an engineer and scientist or shaped your development as an engineer or scientist.  


<p>Then, simply select "OK" to insert the video clip. </p>
We encourage you to add your first hand accounts to the ETHW. To do this, select the First Hand Histories link under the Explore pulldown on any page.  


<p><br> </p>
=== Encyclopedia  ===


== Adding Other File Types (PDFs for example)  ==
A enyclopedic article is a third person description of a person, place, event, thing, or idea. The article requires a balanced exposition that makes reference to all the different credible perspectives. Authors of articles must cite the sources of the information used in their writing. All the registered users of the ETHW can collaborate on any encyclopedic article. Everyones contributions, from the person who first creates the article to all those who add or edit it, is recorded. The "History" reveals the history of all edits. Any given version of a article can be found, compared to other versions, and restored if necessary. Articles do not belong to anyone person. They represent the collective insights of many. You may also wish to add new article, or contribute to existing articles on the ETHW. Please remember, although the subject matter of articles covers all of engineering technologies, they all must have something to do with the history of technology. If there are areas in which you have particular interest, your contributions will be appreciated.


<p>You may have upload files in addition to photos to support your articles and first hand accounts. The files may be in many formats, including PDF, Word, Excel, PowerPoint, Flash Videos). To upload a file that you might link to from within your article, click on "upload file" in the toolbox on the left column of the page. See sample below: </p>
To add a topic, click on the "Encyclopedia" link under the Explore pulldown. at the top and follow the page creation link.


<p>[[Image:Upload.gif|Image:Upload.gif]] </p>
=== Oral Histories  ===


<p>You'll be direct to a page that looks like the one below. Follow the commands to point to the file on your computer that you'd like to add to the GHN. </p>
An Oral History is an interview with someone with historical knowledge conducted by someone with historical training, in order to convert memory into a formalized historical document. Many societies on the ETHW have longstanding Oral History programs through which an official interview with a significant figure in engineering or science conducted by specially-trained staff and volunteers. Its contents are set by what was discussed during that interview.  


<p>[[Image:Upbox.jpg|Image:Upbox.jpg]]<br> </p>
==== Difference between First-hand History and Oral History  ====


<p>Chose a destination filename that will tell something about the image and is easy to recall.<br> </p>
A First-hand History is an article originated by the person or persons who experienced or contributed to the historical subject. An Oral History is conducted by an interlocutor, questioning the subject with the first hand experience. More simply, you can record your own first-hand experience on the ETHW as a First-hand History. Oral Histories are recorded in an interview format by trained staff. As such, First-hand Histories can be updated, but only by its author or authors. Each Oral History is fixed by agreement of the interviewer and interviewee.  


== Categories ==
=== Archival Texts, Images, Audio, and Video ===


<p>Whether you are writing "Topic Articles" or "First-Hand Accounts," assigning categories to your contribution is very important because it will make your article more accessible to those who are searching for information within a certain category. At the bottom of the page, when in Edit mode, you will see a box labelled Select Catergories. Click on the button on the right will activate a pull down menu of high-level categories. Look down the list and select the category that best suits your article. To further refine the classification of your article, the subcategory choices appear in a second box, with a pull fown menu of choices.&nbsp; </p>
To provide a virtual archive for users of the ETHW, image, audio and video files, and scanned versions of archival texts can be uploaded onto the ETHW. These items cannot be edited.  


<p>[[Image:Category.gif|Image:Category.gif]] </p>
=== Published Material  ===


<p>If you feel that several high level categories are relevant to your article, then click on "Select another Category." </p>
Published material cannot be edited. A published materials page contains a short description of the material and a link to a pdf document containing the article.  


<p>[[Image:Addcat.gif|Image:Addcat.gif]] </p>
== Writing and Editing Modes  ==


<p>The pull down menus in the IEEE GHN used for classifying content represent a synthesis of the IEEE Indexing system for articles and the LIbrary of Congress classification system. </p>
The ETHW allows contributors to use two different modes, [http://www.mediawiki.org/wiki/VisualEditor VisualEditor] and Wikitext. You can select either under the Actions pulldown when logged in.


<p>Because are site is still in its embryonic stage, searching by categories will often produce empty results. But as the IEEE GHN grows, the various categories will start to fillup with and then then the categories, in addition to our word searches, will provide a powerful tool for browsing the content on the site. </p>
Wikitext allows for the more advanced user to accurately format the pages. If you are comfortable with using markup languages, see [[Help:Wikitext Formatting and Style Guide|Wikitext Formatting and Style Guide]].  


== Providing Feedback  ==
== Providing Feedback  ==


<p>We appreciate your assistance in providing feedback on the GHN. &nbsp;We'd like to know what is working well for you, and what suggestions you have for improvements.&nbsp; The Feedback page is divided into various sections. Please enter your comments in the appropriate section. To input, just click at the "edit" function which appears at the end of&nbsp; section and then add you comments at the bottom of the existing feedback. It may be helpful if you read the the feedback of others before entering your own. Someone else may have already given the same feedback. Also give a glance at the Discussion tab for the Feedback page. As always, feel free to participate in any discussion thread, or start a dicsussion thread, on any item on the Feedback page. Simply [http://www.ieeeghn.org/wiki/index.php/GHN_talk:Feedback click here] to let us know! </p>
We appreciate your assistance in providing feedback on the ETHW. &nbsp;We'd like to know what is working well for you, and what suggestions you have for improvements.&nbsp; The Feedback page is divided into various sections. Please enter your comments in the appropriate section. To input, just click at the "edit" function which appears at the end of&nbsp; section and then add you comments at the bottom of the existing feedback. It may be helpful if you read the the feedback of others before entering your own. Someone else may have already given the same feedback. Also give a glance at the Discussion tab for the Feedback page. As always, feel free to participate in any discussion thread, or start a discussion thread. Simply [[Special:Contact|let us know!]]
 
<p>[[Image:Feedback.gif|Image:Feedback.gif]] </p>
 
<p></p>
 
<p></p>
 
<p></p>
 
<p></p>
 
<p></p>
 
<p>[[Category:IEEE|{{PAGENAME}}]]</p>

Latest revision as of 14:14, 26 July 2021

Instructions First Time Contributors

This page is intended to provide information on who can contribute to the Engineering and Technology History Wiki and what kind of content can be added to the site.

What is the Engineering and Technology History Wiki?

The ETHW is a website dedicated to preserving and promoting the history of innovation in the history of electrical, electronic, and computer technologies and allied disciplines. The wiki-based site is designed for the public to browse and populate it with their experience, knowledge, and insights. The ETHW will also invite professional historians to share their interpretations of the processes of technological change and innovation. In time, the site will serve as a central historical repository of all the achievements, ideas, and first-hand knowledge of engineering society members, societies, councils and technical communities. It also will also provide a central location for all materials related to engineering’s organizational history.

What Can You Share?

The ETHW has made it easy for people to contribute their knowledge and memories on just about any topic. Create a user ID and password, and you’ll be able to review and edit existing content, and add topic threads not yet available. You can upload photos, drawings, diagrams, documents (in both word and PDF format), and video and audio recordings. The idea of the site is to serve as a living electronic memory of all the important contributions made by people to technological progress -- all around the globe. The site will never be complete -- it will continually grow and expand to be a central site for members and others to explore the history of technological innovation.

Who Can Contribute and Edit Content?

Anyone can register on the ETHW creating a account using the account creation form. Simply log into the site using your ETHW membership user ID and password, and you’ll be able to tell your own story in your own words, while enhancing it with photos, drawings, diagrams, documents (in both word and PDF format), and video and audio recordings. Create Content form

Who Can Participate in Discussions?

Any user is invited to participate in discussions. You do not have to be logged-in to participate in discussions.

The Historical and Technological Scope of the ETHW

The admissible range of technologies for historical presentation within the ETHW is very wide – anything that involves the history engineering and technology broadly construed. Examples, to mention just a few, range from bridges, microelectronics, oil wells, giant electric power stations, steam engines, bio-medical applications, the internet, space travel, ocean engineering, geosciences, video games, to music and movies.

Because of the preservation function of the ETHW and the fact that it is a repository of data for future historians, general articles and first-person accounts are allowed to cover right up until today. Certain other sections will be restricted to people, events and innovations that have occurred at least 25 years ago, including the IEEE Milestones program. Historians have developed various guidelines for how long ago an event must have occurred to be considered ‘historical’, as such certain archival functions may be restricted to conform with such guidelines.

Content areas

Create Content form

First Hand Accounts

Engineers, scientists and related professionals have long been the main actors in the drama of technological innovation. Knowing their stories is essential to understanding how and why technology has progressed as it has for the benefit of humanity. A first-hand account is written in the first person, using the pronouns “I” and “we.” A first-hand account is the recollection of an event, as seen through one person’s eyes.

First-hand accounts are very important to understanding the history of technology because they provide the experiences of those directly involved in the acts of discovery, design, invention, R&D, testing, production, and all other the elements shape the process of technological change. First-hand experiences are the accounts of the "actors" themselves. First-hand experiences need not be confined to products and services you worked on or used, they can also refer to your broader development as an engineer; your training and education, your professional affiliations In short, in First-Hand Accounts, you can write about anything that flowed from your work as an engineer and scientist or shaped your development as an engineer or scientist.

We encourage you to add your first hand accounts to the ETHW. To do this, select the First Hand Histories link under the Explore pulldown on any page.

Encyclopedia

A enyclopedic article is a third person description of a person, place, event, thing, or idea. The article requires a balanced exposition that makes reference to all the different credible perspectives. Authors of articles must cite the sources of the information used in their writing. All the registered users of the ETHW can collaborate on any encyclopedic article. Everyones contributions, from the person who first creates the article to all those who add or edit it, is recorded. The "History" reveals the history of all edits. Any given version of a article can be found, compared to other versions, and restored if necessary. Articles do not belong to anyone person. They represent the collective insights of many. You may also wish to add new article, or contribute to existing articles on the ETHW. Please remember, although the subject matter of articles covers all of engineering technologies, they all must have something to do with the history of technology. If there are areas in which you have particular interest, your contributions will be appreciated.

To add a topic, click on the "Encyclopedia" link under the Explore pulldown. at the top and follow the page creation link.

Oral Histories

An Oral History is an interview with someone with historical knowledge conducted by someone with historical training, in order to convert memory into a formalized historical document. Many societies on the ETHW have longstanding Oral History programs through which an official interview with a significant figure in engineering or science conducted by specially-trained staff and volunteers. Its contents are set by what was discussed during that interview.

Difference between First-hand History and Oral History

A First-hand History is an article originated by the person or persons who experienced or contributed to the historical subject. An Oral History is conducted by an interlocutor, questioning the subject with the first hand experience. More simply, you can record your own first-hand experience on the ETHW as a First-hand History. Oral Histories are recorded in an interview format by trained staff. As such, First-hand Histories can be updated, but only by its author or authors. Each Oral History is fixed by agreement of the interviewer and interviewee.

Archival Texts, Images, Audio, and Video

To provide a virtual archive for users of the ETHW, image, audio and video files, and scanned versions of archival texts can be uploaded onto the ETHW. These items cannot be edited.

Published Material

Published material cannot be edited. A published materials page contains a short description of the material and a link to a pdf document containing the article.

Writing and Editing Modes

The ETHW allows contributors to use two different modes, VisualEditor and Wikitext. You can select either under the Actions pulldown when logged in.

Wikitext allows for the more advanced user to accurately format the pages. If you are comfortable with using markup languages, see Wikitext Formatting and Style Guide.

Providing Feedback

We appreciate your assistance in providing feedback on the ETHW.  We'd like to know what is working well for you, and what suggestions you have for improvements.  The Feedback page is divided into various sections. Please enter your comments in the appropriate section. To input, just click at the "edit" function which appears at the end of  section and then add you comments at the bottom of the existing feedback. It may be helpful if you read the the feedback of others before entering your own. Someone else may have already given the same feedback. Also give a glance at the Discussion tab for the Feedback page. As always, feel free to participate in any discussion thread, or start a discussion thread. Simply let us know!

Retrieved from "https://ethw.org/w/index.php?title=Help:For_First_Time_Contributors&oldid=185688"

Powered by MediaWiki
Powered by Semantic MediaWiki