సాఫ్ట్వేర్ కోసం ఒక యూజర్ మాన్యువల్ ను ఎలా వ్రాయాలి

విషయ సూచిక:

Anonim

తరచుగా పిరుదులను, ఎక్రోనింస్ మరియు ఒక పిహెచ్డిని అర్ధం చేసుకోవలసిన దిశలను నిండి, సాఫ్ట్ వేర్ యూజర్ మాన్యువల్లు కొన్నిసార్లు ఒక డెవలపర్ యొక్క అభిప్రాయము నుండి వినియోగదారు కంటే కాకుండా వ్రాయబడతాయి. ఫలితంగా, గైడ్ తరచుగా తప్పు అని రీడర్ నైపుణ్యం స్థాయి గురించి అంచనాలు చేయవచ్చు. ఒక మంచి యూజర్ మాన్యువల్ వ్రాసే మొదటి దశ వాస్తవ ఇంజనీర్ల నుండి సాధ్యమైనంత వాస్తవమైన వ్రాత ప్రక్రియను పొందడం.

సాఫ్ట్ వేర్ డెవలపర్ ఎవరో కన్నా ఎక్కువ సాఫ్ట్ వేర్ ను పని చేస్తుంది, కానీ డెవలపర్ మార్గదర్శిని వ్రాసేందుకు కాదు. దీనికి విరుద్ధంగా, ఇది ఒక భిన్నమైన ప్రతికూలత. సాఫ్ట్వేర్ యొక్క లోపలి పనితీరు గురించి లోతైన అవగాహన కన్నా చాలా ముఖ్యమైనది, తుది వినియోగదారు ఎవరు, అతని విద్యా స్థాయి మరియు ఆ చివరి వినియోగదారు సాఫ్ట్వేర్ను ఎలా ఉపయోగిస్తారనే దానిపై అవగాహన ఉంది. అనేక సందర్భాల్లో, తుది వినియోగదారులకు ప్రోగ్రామింగ్ యొక్క నాణ్యమైన పాయింట్లు మరియు సాఫ్ట్వేర్ యొక్క బ్యాక్ ఎండ్ పనితీరును తెలుసుకోవలసిన అవసరం లేదు - వారి ఉద్యోగాలను సులభంగా ఎలా ఉపయోగించాలో వారు తెలుసుకోవాలి.

వాడుకరి పరీక్ష

వినియోగదారు మాన్యువల్ ఎక్కువగా ఎక్కువగా వివరణాత్మకంగా కాకుండా, ఎక్కువగా వివరణాత్మకంగా ఉండాలి. మాన్యువల్కు ప్రత్యేకమైన పనులను ఎలా నిర్వహించాలో అర్థం చేసుకునేందుకు సహాయం చేయటానికి వ్రాతపడినందున ఆ రచయితలు ఆ పనులు గురించి కూడా అవగాహన కలిగి ఉండాలి మరియు ఫలితంగా, ప్రతి విశిష్టత యొక్క ప్రతి వివిక్త అడుగు ద్వారా వెళ్ళడం చాలా అవసరం. రచయిత తప్పనిసరిగా రూపకల్పన లేదా అభివృద్ధి దృక్పథం నుండి ఎలా సృష్టించారో తెలుసుకోవటానికి అవసరమైనది కాదు, కానీ దాని అన్ని లక్షణాలపై ఒక బలమైన పని జ్ఞానం కలిగి ఉండటం అవసరం. ప్రతి విధిని నిర్వర్తిస్తున్నప్పుడు, క్లిక్లు, డ్రాప్-డౌన్ మెనులు మరియు ఇతర చర్యలు సహా ప్రతి దశను వ్రాయడానికి సమయాన్ని వెచ్చించండి.

ఇంటర్వ్యూ ప్రాసెస్

డెవలపర్ మాన్యువల్ వ్రాసేది కాకపోయినా, ఆమె ఇప్పటికీ రచయితకు విలువైన వనరు అవుతుంది, మరియు రచన ప్రారంభించే ముందు, రచయిత, డెవలపర్ మరియు ఇంజినీర్లు మరియు సంభావ్య తుది-వినియోగదారులకు మధ్య ఒక కిక్ఆఫ్ సమావేశాన్ని ప్లాన్ చేయండి ఆరంభం నుండి రచయిత రచన. విషయ సూచనలతో నిపుణుల మరియు ఇంజనీర్లతో ఇంటర్వ్యూలు నమోదు చేయబడాలి, తరువాతి సూచన కోసం తయారు చేయబడిన ట్రాన్స్క్రిప్ట్స్ తో.

ఊహాచిత్రాలు

ఒక యూజర్ మాన్యువల్ చాలా టెక్స్ట్-హెవీ ఉండకూడదు. బదులుగా, గ్రాఫిక్స్ మరియు స్క్రీన్ క్లిప్లు యొక్క ఉదార ​​వాడకాన్ని చేర్చండి. చర్య యొక్క వర్ణన స్పష్టంగా ఆ దిశను స్పష్టంగా వివరించే స్క్రీన్-క్లిప్తో పాటు టెక్స్ట్-ఆధారిత దిశలతో చాలా స్పష్టంగా ఉంటుంది. ప్రతి చర్య తీసుకోవడానికి ముందు స్క్రీన్ ఎలా ఉంటుందో చూపించడానికి, ముందు మరియు తర్వాత వీక్షణలు రెండింటిని చేర్చండి మరియు చర్య తీసుకోబడిన తర్వాత ఏమి జరుగుతుంది. మైక్రోసాఫ్ట్ విండోస్లో చేర్చబడిన స్నిపింగ్ టూల్ వంటి సాధారణ స్క్రీన్ సంగ్రహ వినియోగం ఈ చిత్రాలను సంగ్రహించడానికి బాగా పనిచేస్తుంది. ప్రతి చిత్రం సంఖ్యను నిర్థారించి, క్లుప్తంగా ఇది వివరించే శీర్షికను చేర్చండి. మొదట చిత్రంలో చిత్రీకరించిన భావనను పరిచయం చేసిన పేరా క్రింద ఇది కేంద్రంగా ఉంది.

ఫార్మాటింగ్

ఒక సాంకేతిక పత్రంలో స్పష్టంగా కమ్యూనికేట్ చేయడానికి గైడ్ అంతటా ప్రమాణాలకు ప్రణాళిక మరియు జాగ్రత్తగా కట్టుబడి ఉండాలి. ప్రెజెంటేషన్, భాష, మరియు నామవర్గీకరణ రెండింటిలో ఉన్న స్టాండర్డ్స్ గందరగోళాన్ని నివారించడానికి సహాయపడతాయి. టెంప్లేట్లు అందుబాటులో ఉన్నాయి మరియు ఇవి ఏకీకరణకు మంచి ప్రారంభ స్థానం కాగలవు, అయినప్పటికీ వీటిని ప్రతి పరిస్థితికి తగినట్లుగా మార్చవచ్చు. సింగిల్ కాలమ్తో ఒక అంగుళాల మార్జిన్ను ఉపయోగించి గ్రాఫిక్స్ని జోడించాల్సిన అవసరం ఉంది; రెండు కాలమ్ సెట్టింగులు చాలా రద్దీగా కనిపిస్తాయి, మరియు చిత్రాలు గందరగోళానికి గురవుతాయి.

సంస్కరణ మరియు ట్రాకింగ్

ఏవైనా ఇతర డాక్యుమెంట్ కంటే, ఒక సాఫ్ట్వేర్ యూజర్ గైడ్ పూర్తికావడానికి ముందే బహుళ నిద్రావస్థాల గుండా వెళ్ళే అవకాశం ఉంది మరియు పలువురు వాటాదారుల ద్వారా సమీక్ష ప్రక్రియ ద్వారా వెళ్ళవచ్చు. మైక్రోసాఫ్ట్ వర్డ్లో ట్రాక్ మార్పుల లక్షణాన్ని ఉపయోగించడం ప్రతి వ్యక్తి యొక్క వ్యాఖ్యలను మరియు మార్పులను ట్రాక్ చేయడానికి ఒక సులభమైన మార్గం. ప్రతి పునర్విమర్శ చక్రం తర్వాత వివిధ వెర్షన్లను సృష్టించడం, వేరొక ఫైల్ పేరుతో ప్రతి ఒక్కటి కూడా ఈ ప్రక్రియకు సహాయపడుతుంది మరియు అంతా తుది ఫలితంతో అన్ని వాటాదారులను సంతృప్తి పరుస్తుంది.