Questions tagged [documentation]

The tag has no usage guidance.

Filter by
Sorted by
Tagged with
-1 votes
4 answers
611 views

Should I censor out my personal information from screen shots?

I am updating the docs for a system. They will be client facing. Part of the task involves taking screen shots of myself using the system. Sometimes my full name and company email address are in the ...
user avatar
-5 votes
2 answers
241 views

As per the current trend Employee Bond are still in Demand in India? [closed]

To all HR are employee bonds are still demand or is there any other option to bound employees with the company? I am from IT Service Sector and having private limited company and my team size is ...
user avatar
0 votes
2 answers
546 views

Does HR of my company have an obligation to provide related documents

Just wanted to know, if an HR department has an obligation towards employees. Let's say I need a document of employment generated by HR, needed by a service provider. I am following up with HR for ...
user avatar
  • 430
1 vote
2 answers
372 views

Adding author information in internal office reports. Is it a good practice?

I am currently in a new contractual job and am writing documentation of the software architecture I have implemented as a part of my work This document will be reviewed by third parties. I was asked ...
user avatar
  • 496
3 votes
4 answers
713 views

Is there an anti-pattern describing the preference for a new software when the problem is lack of skill or organisation?

I have the feeling that many people tend to turn to a new software instead of trying to master the one available. I am not saying that existing software should not be discarded if it lacks features. ...
user avatar
  • 147
2 votes
1 answer
405 views

What else can I do in order to encourage colleagues to read what I write?

A common problem in corporate environment is that things such as documentation, reports and emails are usually badly written, and so are rarely read. Usually, I try to do my best at communicating. I ...
user avatar
6 votes
1 answer
682 views

How can I actually get people involved to reduce my bus factor without revealing my intentions to leave?

I am currently applying for new jobs, so I'm planning my exit. And since I am the subject matter expert for an entire tech product, I've been doing my best to create as much documentation as I can to ...
user avatar
  • 674
1 vote
4 answers
420 views

How can I persuade my boss for better programming documentation?

I have been at my job for a couple of years now. I was brought on at a novice stage of the programming team, where it began to be officially recognized by the company, then quickly and largely ...
user avatar
1 vote
5 answers
325 views

Define responsibilities on a peer-to-peer level

I work in an agile environment. People have a lot of intrinsic motivation, but something is missing. It is not clear who is responsible for what. One part of my job (I have chosen this task. Noone ...
user avatar
  • 171
1 vote
1 answer
1k views

Company is asking for my documents, salary slip etc but not told me status of my application yet

I was interviewed by a company through 3rd party (Elitmus job portal) after 2 days I checked my status on Elitmus as "Not selected". Now after a week HR personally mailed me to fill a 4-page ...
user avatar
-1 votes
3 answers
657 views

How should I cover my back when my company is unorganized? Specifically with updated contracts/documentation for raises and bonises

TL;DR I have had raises but no updated contract/official documentation, only communications via Slack. A little background: I have been working at this company for around 9 months now and in that ...
user avatar
  • 5,116
5 votes
1 answer
340 views

What are the recommended paper size requirements for printing professional documents (Plain A4/Letterhead/Bond Paper)?

Recently I came across one of my friend's experiences while he was under his notice period with the HR manager of the company. I need an HR professional's advice or people with good knowledge on the ...
user avatar
-2 votes
1 answer
391 views

Do any companies have comprehensive internal documentation that is public? [closed]

By comprehensive internal documentation, I mean pages / documents that explain how team members do their jobs, and one place that connects all these pages. The purpose of these are to train new team ...
user avatar
2 votes
2 answers
681 views

HR rep may have asked me to falsify date on I-9

I started a new job several months ago. The company did not give me the I-9 to complete until my third day of employment. One section of the document is supposed to be filled out on or before the ...
user avatar
  • 41
21 votes
6 answers
10k views

How can I send home personal information from work? [closed]

What is the best method of transferring documents from my work laptop to my home laptop? I frequently want to bring home documents from work. These are generally either: Paystubs Only available ...
user avatar
  • 455
-2 votes
1 answer
575 views

Is a scanned copy of a passport necessary for an offer in the UAE? [closed]

Recently my friend got an offer in UAE, for release an offer letter consultancy is asking passport copy. Is it necessary to send scan'd copy of a passport for getting offer letter. And how to accept/...
user avatar
2 votes
1 answer
733 views

Is forging internal documents at work a crime? [closed]

I currently work in a semi truck repair facility. Where we regularly do services and federal inspections on trucks for the Department of transportation. We have an internal computer program that logs ...
user avatar
  • 31
0 votes
2 answers
540 views

Any reasons to not go paperless at work? [closed]

I'm considering going paperless at work. Just keep notes electronically, using a tablet. Anyone else done this? Any reason to keep a notebook, file cabinet for projects this day and age? Engineering ...
user avatar
2 votes
5 answers
3k views

What are the potential repercussions of taking company files to a new job? [closed]

I have access to amazing engineering designs and calculation spreadsheets for every imaginable civil engineering project. Is it okay to take copies for use at my new job, to facilitate future project ...
user avatar
7 votes
3 answers
22k views

My new employer requested a copy of my passport. Why do they need it?

I started working at a new company, where they asked me to bring a copy of my passport for them to keep. I have worked for many other big companies but they never ask for such document. I should ...
user avatar
0 votes
1 answer
544 views

Is it good practice to sign not very important documents in a shared environment?

I learned about signing documents, so that we can assure integrity and the author attribution. In my company, we already use SharePoint which assigns documents to their creators, and also track last ...
user avatar
  • 157
143 votes
11 answers
21k views

Boss wants me to falsify a report. How should I document this unethical demand?

I work in IT, and my manager is trying to get my coworker and me to submit a falsified security scan to a client of ours. Basically, he wants us to submit a security scan modified to exclude ...
user avatar
19 votes
10 answers
5k views

How to convince boss to spend notice period on documentation instead of new projects

Recently I've signed with a new employer and am currently serving the notice period at my old employer. There's a rather long notice period where I live, given my parameters (13 weeks, Belgium). ...
user avatar
  • 257
3 votes
2 answers
712 views

Will my work experience from a company will be considered without an explicit experience letter?

I worked at a company for 1.5 years, I followed each term and condition as I was fresher that time and I hadn't more knowledge about How IT sector works regarding documentation. I had given a proper ...
user avatar
1 vote
1 answer
375 views

How to document sources of stress in the workplace? [closed]

I have a new boss who is causing much stress, not just to me, but to everyone in the workplace. I can see it in everyone's face every day. The boss stays in the office and does not talk to us much. He ...
user avatar
  • 1,807
4 votes
4 answers
955 views

Is it unprofessional to say my non-technical manager that I'm documenting instead of writing tests, refactoring, etc?

I work in a small company with 4 other developers. Essentially all projects are solo projects. Our manager has a strong sales background, but can write "hello worlds". He knows words like server, ...
user avatar
  • 151
1 vote
1 answer
209 views

What is the best way to do knowledge transfer? [duplicate]

I have just joined the team around three months and the lead developer is resigning. I just have two months worth of time on learning the devops, the workflow and the internal code of the application. ...
user avatar
4 votes
3 answers
824 views

How to respond to plagiarism that attempts to discredit my department?

Several months ago, I sent a document to two people in another department within the same organisation (via email), asking for their thoughts / feedback on its contents. I did this because it was ...
user avatar
  • 1,092
31 votes
6 answers
15k views

How do I write technical handover documentation before leaving a company?

I am serving notice period in my organization, and a project manager has asked me to write down a document on what I have done. I have briefly mentioned the points on which I have worked, but I have ...
user avatar
  • 311
0 votes
1 answer
105 views

What is the process of updating your home address for your workplace? [closed]

I plan on moving in the next few months to a different state but I will still be employed in the same company. I know this might vary with company, but in general what is the process involved in ...
user avatar
  • 123
102 votes
7 answers
24k views

Former manager who left company is asking for documentation I prepared as his direct report

I've been at my place of work 5 years now, and my first manager there left around 2 years ago. (It was not on great terms.) We did not speak until a few weeks ago when he asked to get lunch. We did, ...
user avatar
2 votes
4 answers
247 views

Is it normal for Configuration Management process documentation to be constantly changing? [closed]

I have noticed a re-occurring pattern when working the processes of my software configuration management group which manages many different software baselines; however, I imagine this problem is not ...
user avatar
  • 405
-1 votes
1 answer
5k views

What is the "List of Pre-Employment Inventions by Employee"? [closed]

Today I've got a offer from the company at H.K. then they give some document such as "List of Pre-Employment Inventions by Employee" But I've never seen before that kinds of documents. What is that ...
user avatar
  • 21
0 votes
3 answers
861 views

How to work with a coworker whose initial reaction is to ask me? [duplicate]

I'm a developer. One of my coworkers asks me a question the moment anything goes wrong, or he doesn't understand something, in either our code or even third party code we use. He's a nice enough guy, ...
user avatar
8 votes
3 answers
951 views

How to document a bad project without shaming anybody?

I've taken part in a catastrophic freelancing project full of bad decisions. I left it. As part of the handover, I have to "document my work", which essentially means I have to document the whole ...
user avatar
  • 4,555
17 votes
3 answers
2k views

How to Document Grievances?

A lot of the questions asked here deal about issues between the author and their coworkers, their boss, their clients, so on and so forth. Almost every answer have something in common: document it! ...
user avatar
  • 195
-1 votes
2 answers
119 views

Examples of collaboratively produced organizational culture documents [closed]

I'm looking to facilitate a collaboratively produced team manual of sorts. It would have things like a vision/mission statement, shared principles, rules of thumb, etc. I'm interested in the best ...
user avatar
-2 votes
1 answer
282 views

How do I prepare a technical report containing nothing but mathematics for someone who has no higher education?

I am currently working for a man who is very smart, but to the best of my knowledge has taken no college courses. I would like to prepare a report for him detailing original but very simple (freshman-...
user avatar
  • 335
0 votes
2 answers
642 views

Poor documentation culture [duplicate]

I work in a production company as a design engineer. There is a culture in my company of not documenting things, there are few standards, barely any routines and no documentation system. There is a ...
user avatar
  • 1,849
0 votes
1 answer
89 views

How to inform the employer about delays in obtaining the necessary documentation [closed]

I have to write a formal mail to my employer and I need to advise my employer that there were some delays with the documents requested. I would like to inform him that I am trying to get the ...
user avatar
  • 111
-3 votes
2 answers
289 views

What do you say on bullying documentation if you don't know the exact date of the incident? [closed]

If you are writing a bullying report for HR but you only have a vague idea of when the incident happened e.g. Early in March what do you say? Do you say that you don't know when? Or explain why you ...
user avatar
  • 3,325
1 vote
3 answers
31k views

Does a 'written resignation letter' need to be 'handwritten' or simply 'typed & printed with signature'? [closed]

My employment contract states that my resignation needs to submitted in a 'written communication'. I'm not sure if it means a hand written letter or if it is just a way of saying I need to submit a ...
user avatar
-4 votes
1 answer
1k views

How to document ongoing harassment in a professional way? [closed]

While writing detailed documentation about harassment I'm experiencing, what's the best way to keep it professional without losing its emphasis? For example, my manager called me on Skype and said "I ...
user avatar
  • 3,325
1 vote
2 answers
240 views

Document to convince boss to buy hardware over other hardware [duplicate]

I am looking for advice/guidance (on specific points) on generating/creating a document for convincing my boss to invest in some hardware to make my job easier and more-productive. Background The ...
user avatar
1 vote
3 answers
325 views

How can I incentivize colleagues to create content on a new company Wiki? [duplicate]

The company I work for has a bunch of information laying around; in a dropbox, on a shared network drive, basically there are documents everywhere. To make information more accessable, myself and some ...
user avatar
  • 19
2 votes
1 answer
375 views

How to talk about a coworker work in a report

The context I'm a software developer in my company and I have to write a report about a task I've done this past year. I'm doing this for the sake of maintenance and transparency in the work. In a ...
user avatar
13 votes
4 answers
8k views

How to select an applicant with good documentation skills

We are a local outsourcing company and currently hiring for a technical position (Linux/Network engineer) - however our main objective now is to find someone not only able in the Linux/Networking ...
user avatar
  • 241
1 vote
3 answers
463 views

Documentation - is it an assumed part of the job? [closed]

So I was told from higher-ups that a software engineer that left the company didn't document his processes and he should have as part of his duties. My gut reaction was to say - "you don't get what ...
user avatar
  • 6,109
1 vote
3 answers
440 views

Mention studying leaked documentation in interview

I am interviewing in a few days for a position requiring some skills I am currently missing. This can be solved by reading one of their manuals, which are supposed to be for sale as far as I ...
user avatar
1 vote
2 answers
454 views

Bad documentation - authority undiscerning [closed]

I'm working in a small "team" of 3 programmer, each working on seperate projects. Therefore I'm using in-house SDK's to write software for MCUs, designed and constructed by our company. The SDK ...
user avatar
  • 923