General Guidelines to be followed by OEMs while making Manuals
This document briefly covers the guidelines to be followed by OEMs (Original Equipment Manufacturers) while preparing manuals.
- Administrative Information
- Introductory information
- Definition of Acronyms, Terms and Abbreviations
The above information is also required from OEMs along with approved manuals which are to be integrated into IETM software.
Multiple Skill Level Tracks and Comprehensibility can be followed as per the requirement of the system that is to be delivered. (To be decided by OEM)
The quality of the graphics section is highly advisable to follow. The items and systems hierarchy section is also good to follow.
1. Administrative Information:
All IETM shall contain the following administrative information for subsequent user selectable display:
- Identification of the “Title of The Technical Manual”, assigned “Technical Manual Number”, as applicable.
- Classification Level of the IETM (shall also be presented upon initial entry to the IETM by the user)
- Date, baseline date and dates of the latest/all previous changes.
- Verification, change or revision status as applicable.
- Method of obtaining additional copies and the format of such electronic copies
- Distribution statement.
- Summary of documents and/or technical manuals that are referred in the IETM but not included in the automatically accessible data (hyperlink) available to the IETM.
2. Introductory Information:
All IETM shall contain information, which explains the purpose and scope (e.g., organizational level troubleshooting and corrective maintenance for a particular system), content, and organization of the IETM.
This section shall present the range of tasks covered by the IETM and relate the purpose and scope of the manual.
3. Definition of Acronyms, Terms and Abbreviations:
- A glossary of terms used in the IETM including all acronyms, abbreviations and special terms shall be incorporated in the IETM and shall be directly accessible in all IETM presentations.
4. Warnings, Cautions, and Notes:
Technical information shall be supplemented with warnings, cautions and notes in such a way as to:
- Attract the user’s attention to correct practices, procedures and conditions which, if not adhered to, could lead to injury or equipment damage.
- Warn the user against the performance of certain hazardous actions, and/or,
- Follow specific steps leading to the safe performance of the procedures.
5. Multiple Skill Level Tracks:
- When required, technical information shall be available in multiple skill-level tracks.
- For example, in the case of novice level and expert level skills, technical information shall be available in each of the two separate and complete tracks representing the two skill levels.
- The novice level track shall contain all information necessary to carry out a task step by step, while the expert level track may provide only a checklist or a description in broader terms.
- The expert would have the option of referring to the novice-level information also.
6. Comprehensibility:
The following guiding principles shall be followed to ensure the comprehensibility of data in an IETM:
- Information should be in a descriptive text manner. This text must be consistent in style, terminology, and format.
- The functions of the system/component, the inputs, outputs, interfaces, and principles of operation are to be described.
- Any special features are to be listed and explained.
- The location of the component/part in the system is to be indicated.
- Each paragraph of the text should be limited to a single idea. Each sentence should be limited to a single thought. Short and familiar words are to be used. Rules of Service writing shall be adhered to.
- The length of a sentence shall not exceed 20 words. The average paragraph shall not exceed 6 sentences.
- Steps and explanations shall be constructed as fully integrated text and graphics modules.
- Text shall be presented in a logical order; e.g., as in an operational sequence or in a signal flow sequence.
- The IETM shall contain only the information required. Any additional information which could be useful, but not essentially required, shall be provided as HELP
7. Quality of Graphics:
- Graphics shall be prepared to a scale that ensures that all Essential details are legible. Line widths should be chosen to be seen clearly on any display. However, it should be kept in mind that intensive use of graphics would slow down a system.
a. Angle of view:
- The graphics should represent the views that are generally used. If necessary, more than one view should be provided.
b. Schematic and Wiring Diagrams:
- Cable schedules, schematics, and wiring diagrams displayed along with accompanying text should be displayed to contain only the information referenced by the text with which they are displayed.
- However, the user should be able to see the complete diagram or list if it can be displayed on the screen.
c. Flow Charts:
- These are to be drawn from left to right or from top to bottom.
- The diagrams should indicate the details referenced by the accompanying text.
8. Item/System Hierarchy:
- The weapon system or other equipment that is being maintained and operated is composed of several layers of subsystems, components, and parts.
- This hierarchical representation of the equipment being maintained and operated shall be accomplished by the use of a system element that is used recursively, and which decomposes the equipment into only those components that are being maintained or operated.
- Each component of this hierarchy has associated with it one or more of the following four categories of information.
- Descriptive information
- Procedural information
- Troubleshooting information
- Parts information
a. Descriptive Information:
Descriptive information may provide information on the system (subsystem, component, and part), physical arrangement, functional behavior, theory of operation, and other aspects. Descriptive information shall contain a hierarchy of narrative paragraphs. Paragraphs, in turn, may refer to primitive elements.
b. Procedural Information:
- Procedural information shall be composed primarily of task statements.
- Each task element shall be associated with attributes that provide related information such as: estimated completion time; maintenance level(s) where the task is to be performed; required conditions which must be met before performing the task; and the number of people required to perform the task.
- A procedural element may be linked to other elements, which define the supported equipment, and consumables that the task requires, through the establishment of appropriate relationships.
c. Troubleshooting Information:
Troubleshooting information shall contain data necessary to isolate faults found in a system. Troubleshooting information shall contain fault elements, fault state elements, test elements, outcome elements, and rectification elements.
Fault Elements:
- Fault elements shall identify potential faults, which might occur in the system.
- Fault state elements. Fault state elements shall present a list of faults implicated as the result of a test that has been performed. Each suspected fault in the list shall be weighted, based on the probability that it is the cause of the observed malfunction. The fault state element may also present a list of possible faults that have been eliminated from consideration as the result of tests performed.
Test Elements:
Test elements shall contain a link to the procedural instructions a technician must follow to carry out a required task at a particular juncture in the troubleshooting procedure. Test elements shall also provide all possible test outcomes.
Outcome Elements
Outcome elements shall contain definitions of new fault states associated with the results of a particular test. Outcome elements shall also contain a description of the state of the item being maintained. The final outcome element of a fault isolation procedure shall have a relationship, which associates it with an identified fault. The identified fault has, in turn, associated with it the initial element of the appropriate
Corrective maintenance action.
Rectification Elements:
Rectification (i.e. corrective maintenance actions) elements shall contain references to procedural rectification tasks, checkout tests used to report the success of completed rectification tasks and a list of all faults that the rectification shall repair.
9. Parts Information:
Two types of parts of information shall be included:
Maintainer/Operator Information, and Supply Information: Elements containing either type shall refer explicitly to corresponding elements of the other type. Parts information provided for a system maintainer and/or operator shall include such items as units per assembly and usable-on code.
Mean Time Between Failures (MTBF), and reference designator, if applicable.
(ii) Parts information provided for the parts supply process shall constitute unambiguous identification on a part so that it can be reordered, and may consist of such items as the part number, description, source, system, maintenance, etc.,
10. Naming Convention for Version Control:
Every IETM shall clearly be identified by a
- “Title” followed by a “Version Number”, indicated by 2 integers, starting from “00”. Every change from the release of the IETM will be clearly identified as an incremental integer from“00”.
For example:
- “IETM for Radio Station RRF Ver. 00” – Initial release version
- “IETM for Radio Station RRF Ver. 01” – First revised version
Article written by
G. Gopi Krishna
Code and Pixels
IETM R&D team
I have been searching about ietm,. In online more than 2 hours today, and finally, I found it. Your topic is very nice and valueable it can help each newcomer to know briefly about ietm. I just wanna thanks for the information you wrote. And obviously, sending it my friends.., and I will definitely bookmark your site.. : )
Thank you, Kumar for reading and commenting..!
Useful post” thanks for posting it;s a great idea on writing article about ietm oems. I have read others blogs, but they are confusing.!! I hope you continue to have such quality articles to share with everyone! Thanks in advance 🙂
Glad you liked it, and Thanks for reading and commenting..!!
I am studying this article about IETM and it’s helpful me a lot and got a Idea on IETM thanks for valuable information
Glad you liked it, Chowdary 21 & Keep Reading…!!! Thanks, for commenting..!
Good article and right to the point. I really enjoyed reading this post., thank you!
Thanks and welcome @kaushik
Very excellent and highfy article in this robotic world
Informative article!! It is useful for beginners to understand about IETM,, KEEP SHARING this type of information!!
So nice of you, @Bindya Sharma Keep Reading… For more Updates !!
It’s really nice explanation about ietm and it’s features, its great useful to everyone.
Tank you
Best explanation about ietm features and how software works, you have excellent knowledge about ietm, can you please share more info!! To my mail.
Thank you.
I have been looking forward for good article to learn what is IETM…i found your article..so interesting and understandable..the way of explanation is so nice expecting more articles from your side… thank you so much…for your unique information about IETM….
This content is well-detailed and easy to understand for creating a good content.
It’s really nice article and helpful to everyone, Best explanation about ietm features and how software works, it is excellent knowledge about ietm.
Tank you
Informative content. Now, even people like me, who has less knowledge on this will be able to prepare manuals
It’s really nice explanation about ietm and it’s features, its great useful to everyone.
Tank you
I have seen your article in blog site. It is useful for beginners. Keep doing.
this Article helped me A lot .and i gained more knowledge about ietm levels
This article is helpful
This article is informative and useful
You have such a unique perspective
Informative article!! It is useful for beginners to understand about IETM,, KEEP SHARING this type of information!!
Content is very deeply explained..your every article is informative.
I have seen your article in blog sites, which I have found in accurately useful. Thanks for sharing such a great concent. Keep sharing!!!!!!!!!!
Usefull post thanks for posting
Such AN EXCELLENT 👌 INFORMATION
Useful thought.
Excellent very good job
It was very informative and I personally enjoyed reading it.
Well-articulated! I enjoyed reading your content .Thank you !!!!!!
It’s really nice article and helpful to everyone it is excellent knowledge about ietm.
Tank you
I learning full article which I have found it’s accurately useful I really appreciate you shared with such informative post, great tips and very easy to understand in IETM.
I have seen your article in blog sites, Happy to know about ITEM. Keep posting!
Good article and right to the point. I really enjoyed reading this post., thank you!
Thank you for the information. Loved your blog. Looking forward to more from you.
It’s really nice explanation about IETM and how software works, very nice useful information provided in your article.
Thank you
Informative article!! Very good.It is useful for beginners to understand about IETM, keep sharing this kind of information!!
I really loved it
Such a useful and robust information on IETM!
This demonstrates that code and pixels is the only firm with actual and proper IETM experience in terms of execution and development!
In this fast growing world, To know about IETM is very useful . Thank you!!
This is a nice article. Good use for many people. The idea is good.
I learning full article which I have found it’s accurately useful I really appreciate you shared with such informative post, great tips and very easy to understand
Reply
have seen your article in blog sites, which I have found in accurately useful. Thanks for sharing such a great concent. Keep sharing!!!!!!!!
It’s really nice explanation about ietm and it’s features,
Tank you
Exlent information and very useful
You have excellent knowledge of IETM and have provided the best explanation of its features and operation……
Very useful article for IETM users
It is a one of the best article, I never seen this type of detail explanation
It is Very Valuable information About IETM and Useful to Technical Manual.
Informative article, content are well said
Well detailed guidelines and content information, such an excellent information.
Good job and excellent which is giving up that is next level
Best of luck and keep doing well same as…
I’m so glad you said that! Thanks, for commenting..!
Enjoyed reading this article
Keeping posting such informative articles
Glad to help. Thank you, Shiddhu Singh for reading and commenting..!
I have been searching about ietm,. In online more than 2 hours today, and finally, I found it. Your topic is very nice and valueable it can help each newcomer to know briefly about ietm. I just wanna thanks for the information you wrote. And obviously, sending it my friends.., and I will definitely bookmark your site.. : )
Thank you
Thank you @ajay for your kind words. Keep Reading!!!
Very useful information regarding IETM
just Loved this article … Great explanation
Thank you, @Padma for your kind words.
This information is Very useful Great article
Excellent information. Good article
You’re welcome.
Good information
Good info.
Thanks for sharing
Until I met their team, I had no idea what IETM was.
But after going over this information and doing a demo with them, I am now thoroughly familiar with IETM and its features.
I believe Code and Pixels is the only company in India that has made such strides in IETM development.
Information on IETM that is genuine, relevant, and based on personal experience.
Until this article, I had never come across such fantastic and comprehensive information about the Interactive electronic Technical Manual.
It’s really nice explanation about ietm and it’s features, its great useful to everyone.
Tank you
It is really helpful to everyone and provides a really excellent description of IETM and its features….
Everybody can benefit from this really great explanation of IETM’s features….
Explanation is nice , usefull for every one
Good info
Very useful information
This is Good Information useful to Defence Sectors and Valuable information about IETM Levels and Gain More Knowledge about this Article IETM Levels
I have been looking forward for good article to learn what is IETM It is useful for beginners to understand about IETM KEEP SHARING this type of information.
It’s really nice article and helpful to everyone such a great article you shared thank you so much CODE AND PIXELS.
just now I have seen your article on Blog sites i felt so happy for your information about IETM interesting and understandable..the way of explanation is so nice expecting more articles from your side… thank you so much…for your unique information about IETM.
Useful information
Informative article!! It is useful for beginners to understand about IETM,, KEEP SHARING this type of information!!
Useful post” thanks for posting it’s a great !! on writing article about ITEM && OEM. I read! others blogs, but they are confusing.!! … continue!!! …..such quality articles !!!
Thank you for sharing great information
We get good knowledge of OEM general guidelines and how to make manuals
Nice article…well explained
Well details.
Content is good
useful this article to everyone
It is very useful information about IETM, helpful in future
It’s informative and useful for further good keep going
guidelines to be followed by OEMs while preparing manuals information and Item/System Hierarchy subject very usefull every one, thank you sir
Good job on this one
It’s a very useful for the country lovers those who think of the country wellness and in the point of protection it’s very useful to all of us
Thank you very very much for providing us this information
Great article to know about IETM for the beginner it’s very helpful good information thank you
👍
General guidelines information, instructions, trouble shooting and some categories articles very useful, thank you all
Nice information
General guidelines, manual levels, problems, trouble shooting and other articles are very useful to all
Guidelines to OEMs IETM, Instructions, troubleshooting, software problems and manuals articles are useful to all
Nice well explined👍
Useful information shared about IETM so thank you very much.
i read your article @ medium site, its very nice information about ietm software guidelines! i will definitely share with my students!!! Thanks you keep Posting.!
Thank you,
You’re most welcome, Sir,