Technical Writing

334

Solutions

289

Contributors

Technical writing is any written form of writing or drafting technical communication used in a variety of technical and occupational fields, such as computer hardware and software, engineering, chemistry, aeronautics, robotics, finance, consumer electronics, and biotechnology. IT encompasses the largest sub-field within technical communication. The Society for Technical Communication defines technical communication as any form of communication that exhibits one or more of the following characteristics: "(1) communicating about technical or specialized topics, such as computer applications, medical procedures, or environmental regulations; (2) communicating through technology, such as web pages, help files, or social media sites; or (3) providing instructions about how to do something, regardless of the task's technical nature".

Share tech news, updates, or what's on your mind.

Sign up to Post

1)
May I suggest you something? Please don?t worry about logistics. We can together sort this out. We have a ton of clients from your part of the World and we started using BoTim based on their request only. If you kindly take my suggestion, please let me share the link, you pay, let me book the slot first. Then we have good 5 days to figure the logistics part. David slots gets filled up very quickly and I honestly don?t want you to loose out time. Each day gone is a loss of competitive position as far as Canadian immigration is concerned.

Please go ahead. Rest all will be sorted.
2)
A final query .... Can I attend call along with my friend, if he satisfied, then he also could be your prospective client ?
0
Learn SQL Server Core 2016
LVL 13
Learn SQL Server Core 2016

This course will introduce you to SQL Server Core 2016, as well as teach you about SSMS, data tools, installation, server configuration, using Management Studio, and writing and executing queries.

Dear Team,
I wonder how you are able to respond so fast all over the day ! Much appreciated !

As I said before, Botim app I have never used. Skype need to be tested via VPN.
How can we make sure whether these are going to work prior to our scheduled call ?

==
0
I am not aware of Botim app used for calling purpose.For the skype, I need to check whether is it going to work with some kind of vpn help. I would prefer to have a call on Friday/Saturday. These days are observed as the weekend for us.

Please let me know, If I miss out asking any clarifications during the conversation, can we shoot a mail for our queries?
0
I appreciate expressing your forthright view about my profile.

If there is any fat chances as you suggested, then I would definitely be interested to go with you.
At this point of time based on my below profile, not sure If I can make it to the score-67.

To be honest with you, Currently I have enrolled with one of PR consultant and paid processing fees.
He is suggesting to get score of 67, to create my profile in EE, then only he can take my process further.Same lines as you said in mail, He told me good to have -Canadian job offer, to get the required score.He envisaged that, achieving it impossible. Reason being is,This processes has to be vetted by govt and it is being cumbersome required lot of scrutiny and then eventually luck plays the role.

As am rookie in this subject,Just got confused how to procede further from here?
I saw lot of video's on your youtube channel, hoping you are more trustworthy and take the process to logical end.

Again, I am furnishing more detail information about my profile, that would help you to re-assess my chances of getting visa.
0
which is correct sentence and why

1)
There are possible risks, but nonetheless, we feel it’s a sound investment;
-OR-
There are possible risks, nonetheless, we feel it’s a sound investment;

==
2)
Their team hadn’t lost a game the entire season. but Nevertheless, we beat them by a huge margin last night;
-OR-
Their team hadn’t lost a game the entire season. Nevertheless, we beat them by a huge margin last night;
0
I've run into a silly grammatical question. I have an introductory sentence that refers to a sequential instruction set below. This instruction set is just the basics, and the user can click a link if he wants to see the gory details. :)

So, I have:

To enter minimal information (click here for full instructions):
1,. Enter vendor name.
2.  Enter vendor email.
....
5.  Click "SAVE" when done.

On that first line, is my syntax grammatically correct? Thanks. If not, how should it be modified?

Thanks,
Steve
0
Hello,

For a web application, documented in a Wiki, I have a data element (call it THING) which can contain one or more WIDGETS  There exist two places in the instruction set for THING where I refer the user to the separate instructions for WIDGET.

TO ENTER A THING:

1. blah blah blah
2. Enter a Widget. Click here for info. ("Here" takes you to a separate section for widget entry,))
3. To generate additional sequential widgets (one more month)
     a. Click "GENERATE SEQ"
     b. Enter number of Widgets
     c. For each month, enter a widget. Click here for info.
4. Enter notes for the Thing.
5. Click OK to Save.

My instructions to enter a widget are somewhat involved, and, in the interest of "reusability" are contained in their own section.

Widget Entry: (located in its own section which I can link to.)
1. Enter cost.
2. Enter date.
3 etc.
4 etc.

To my question: after user completes step 4, I want him to return to the "Thing" instruction at the point where he left off. (which could be one of two places. How can I best handle this situation. I see two possible ways:

1. Say nothing, and trust that the reader will know to click the BACK Button to return to where he left off in the instructions.
2. Write something like "Return to Enter Thing instructions where you left off" to gently nudge him to hit the BACK button. (To avoid the temptation for wandering eyes to continue with the next section in the document.)

Thanks,
Steve
0
which one below is correct and why
==========

lately, my height has increased tremendously
lately, my height has been increased tremendously
0
which one below is correct and why
==========

I have a car / I had a car
I had little interest in driving / I have little interest in driving

==
0
In a user document, I have something like the following (scrubbed).

Select a company name. (e.g. Microsoft)

Do I need a period after "Microsoft"?  I'm leaning toward not needing it b/c "e.g. Microsoft" is not really a sentence, but then again, what do I know?

Thanks.
0
Build an E-Commerce Site with Angular 5
LVL 13
Build an E-Commerce Site with Angular 5

Learn how to build an E-Commerce site with Angular 5, a JavaScript framework used by developers to build web, desktop, and mobile applications.

I have a series of apx  25 documents that describe 25 instances of a configuration screen on which you select - or enter - one or more data elements.. Each screen deals with a different concept (e.g. age, gender, etc).) But they all have common elements (e.g. how to clear all settings, how to display only selected items etc.

I'm leaning toward including these concepts on each of the 25 pages. (Ease of reading for our audience.) But, if, for some reason, our developers change the process of (e.g.) deleting all data elements), they I'd have to change it in 25 places.

I guess I could include these commands on a separate page, and simply say (on the 25 pages), "Click here for global commands."

Thoughts?
Thanks,
Stephen
0
Planing marriage and property distribution
---------------------
I agree with the view that, this is the right time to start searching a groom for NANCY. As I had already explained to mother regarding this subject, The solution is, let get over the property distribution process, then we will get to know how much share NANCY’s family is going to own, based on the outcome we can make a better decision for her life. Apart from that, MARIA also in the pipeline for similar reason, possibly within a period of 1-2 years, the above solution will fix the issue once for all. By doing so, will get the opportunity to know, Do they even need any support system at all from outside. Moreover, As for as NANCY’s family concern, the property they expected to get, none but she is going to own it as no other heir to share it. Regarding MARIA,  having $1 Million property with clear title in hand, which they can liquidate anytime, PLUS agri land which they are anticipating, aggregate of the both, would be more than sufficient not just for her marriage, even for next family generation needs. Now, If we go with your thought process for NANCY’s, then people would expect to apply same logic in case of MARIA also.

Having said that, Uncle categorically agreed to take care of all monetary expenses which would incur for her marriage. I made this to happen because neither he looked after BOTH families after their guardian passed away, nor done any justice yet to get their share of the property, and …
0
===  Giving advise to distribute family property which has been pending ... casing problems in a family
Uncle's lackadaisical attitude getting things even worse for each passing day to get our due share from the joint property, on which PAUL lifeline solely depended on. The delay made us to lose all Govt benefits for every now and then, very lately allowances which has started giving away for every 6 months based on size of land, and typical loan waivers offered when every new Govt assumes the office, which has been going on since ages. The sum total so far has been very huge and counterproductive so far to NASAR progress too. If this situation lingers for more time, In the prevailing social landscape, and with the changing Govt policies with the time, then it is almost impossible to dream to get the due share in property our lifetime. This effect already visible in the form of huge mistrust brewing while distributing crop share amount to relevant shareholders. For all these kind of nonsensical things I hold him responsible.

In conclusion, Let Uncle react positive to culminate property distribution process, the subsequent process would be transparent everyone to see how to plan their future support system and needs. This is an opportunity to all of us, what they are going to own vis-a-vis Needed in future, else Uncle has to take care of all expenses End-2-End for GIRL1 marriage and also for one more similar on the cards offing now. Now entire onus lies on him. Otherwise,…
0
Hi,

I'm documenting a connected series of screens that contains list of geographic locations. There are three screens;
  • Continent
  • Country
  • State

Each geographic entity can be assigned a value. e.g.
  • North America = 3
  • USA = 6
  • Ohio = 4

The returned value is the one for the most specific entity:]
  • If you are in Ohio: 4
  • If you are in the USA but not in Ohio: 6
  • If you are in North America but not in USA: 3
For this document, I have an intro, and then three sections (Continent/Country/State)

Would it be better practice to repeat the above derivation of the returned value in each section (3 instances) or just once (in the intro).  My concern is that if I put it in the intro, and someone is reading only the State section, they'd miss out on this explanation.

What you do think?

Thanks,
Steve
0
which one is grammatically correct and why
==============================================
we dont need to go there because,we have not been invited.

we need not go there because,we were not invited.
0
which one is grammatically correct and why
===================================
1)
I wrote a book when I was in USA
I had written a book when I was in USA

2)
postman bought  a letter.   It was given to your mother.
postman  bought a letter.It has been given to your mother.
==
0
which one is correct and why ?
========================

you are not be permitted to go into theater if you dont have a ticket
you are not going to be permitted to go into theater if you dont have a ticket
you will not be permitted to go into theater if you dont have a ticket
0
Grammatically which one is correct, appreciate if you can add the reason too...
===================================================================
1)
This road  was not repaired for the last 5 years
This road  has not been repaired for the last 5 years

2)
this work must be completed in  a week
this work has to be completed in a week

3)
this work is not going to be completed in 2 days
this work won't be completed in 2 days

===
0
== Requesting company HR to share contact details of my previous colleagues ===

I am John,former colleague of David, who is working as Project Manager in your organization, had been associated with him during our previous job role with HP, Florida.
I would need to reach him for some personal purpose.

Kindly advice  ..
0
OWASP: Forgery and Phishing
LVL 13
OWASP: Forgery and Phishing

Learn the techniques to avoid forgery and phishing attacks and the types of attacks an application or network may face.

I've been testing Ginger in free mode for a while and they keep bugging me to upgrade (~$59 per year), but I am wonder about alternatives. Rather, I am wonder what you folks consider as the best on-line grammar checker, and why?

I have used Grammarly in the past but I recall that it often missed obvious errors and sometimes made erroneous suggestions. But that was about three years ago. I also know that there are a few other grammar checkers available.

Two Two that I have used are:
- Ginger https://www.gingersoftware.com
- https://www.grammarly.com

Criteria for answering
- Please don't suggest that there is no substitute for understanding English grammar. I know this. But these tools are still great for finding errors when one makes the occasional mistake.
- Please don't suggest the free tools in Microsoft Office. I don't have access to Office.
- I am primarily editing in Google mail and the Google Apps.
- I am only concerned about English grammar checking.

I'll look forward to your comments and suggestions. :)
0
In a web application, I have a field in a table that contains the following (scrubbed):
what is this
You can mouse over STATUS to display a popup that shows "Approved", "Deferred" etc.

But, what do you call STATUS. It's not a link, and not sure if it should be called an icon. But, if "Icon" is appropriate, I'll run with it. Thanks.
0
========= Seeking clarifications about documents  for my PR process ============
regarding ABC company experience ...I hope to get the "Roles and responsibilities" on their letter head very soon for my PR process.

Apart from above, I have  1) Exp letter & 2) Reliving letter, with me.

ABC is a human resources consultancy,  and no contemporary consultants are currently in touch.I used to depend on ABC only for my HR related needs.
whereas their customer-- "IDB bank"where I had worked ,  I have known contacts.
 
Hope the above three documents are sufficient.

please advice
0
============ Writing email to my previous company-ABC HR, Requesting her for employment refernce letters for my PR process  =======

It has been long time since I left the organisation. I must say experience with ABC had been wonderful, and its transparent HR process.
Still I miss the annual gatherring parties.Hope such parties still ABC keeping alive.

regarding reference letters I requested for my PR...
you might have provided such reference letters so far, for many PR aspirants. I didn't exactly get the reason for the delay getting requested letter.
If the reason for my employment,  my experience letters sent you in earlier communication, hope that will give you enough details.
More details you can get from your internal employee database.

About my job roles,as a IT Consultant,the document sent you mentioned most generic roles not to make it complicated.

I am waiting for your letters to procede next level of processing for my PR processing.

I am sure, you will help me getting the required documents in this regard, also wishes me to succeed.

I really appreciate your help
XXX
0
=  Writing mail for whatsup admin, reminding him  for not getting delivered daily lessons through his broadcast list =
Hello,

This is to inform you that, I have not received the -  Day-21 Evening lesson again.
Can you please kindly check again, whether my below number has added to your whatsup broadcast list.

my num # +1234567  ( Make sure '+' sign before the number).

Making you uncomfortable daily with reminders to send me lessons individually , I am feeling apologetic for that.

Just for Info, my cell has always been connected to High-Speed 4g, and it is a Samsung Note.
0
yesterday I received an update about my education credentials status.
One of the transcript not been accepted mentioned the below-given reason.
===  reason ==
XXX
====

Kindly advise, Shall I send you the photocopy of a statement of marks sheet which has the clear visibility to support my - "Statement of Marks-Transcript" submitted to you earlier.
0

Technical Writing

334

Solutions

289

Contributors

Technical writing is any written form of writing or drafting technical communication used in a variety of technical and occupational fields, such as computer hardware and software, engineering, chemistry, aeronautics, robotics, finance, consumer electronics, and biotechnology. IT encompasses the largest sub-field within technical communication. The Society for Technical Communication defines technical communication as any form of communication that exhibits one or more of the following characteristics: "(1) communicating about technical or specialized topics, such as computer applications, medical procedures, or environmental regulations; (2) communicating through technology, such as web pages, help files, or social media sites; or (3) providing instructions about how to do something, regardless of the task's technical nature".