Questions tagged [writing]
According to Wikipedia, writing is a medium of communication that represents language through the inscription of signs and symbols.
21 questions
0
votes
1
answer
5k
views
How to determine ideal chunk size for file writing?
I have a class that is responsible for writing formatted binary objects to a file on a network drive with a 100Mbps bandwidth.
Each time an object is created (via lets call it w.addObj()) it formats ...
- 1,047
2
votes
4
answers
159
views
How do I write, review and coach better English language in documentation?
My job regularly involves writing and reviewing (in the form of pull requests) English prose in the documentation for our internal system, which solely faces other developers, in a strongly American ...
- 525
0
votes
1
answer
4k
views
Who writes functional specifications and how to track what has been done in a clear and effective manner [closed]
Background:
In a project where I work as a developer we did not use a functional specification at first. We relied solely on technical documentation, issues in Jira and mockups/detailed design for ...
- 119
1
vote
1
answer
6k
views
How do I write a message for a commit that resolves a merge conflict? [closed]
Say you commit, pull, have a conflict, resolve the conflict, and then commit. Since the local change already has a commit with a meaningful message and the remote change being pulled has its ...
- 297
1
vote
1
answer
143
views
Is there an easy way to type in common math symbols?
Disclaimer: I'm sure someone is going to moan about easy-of-use, for the purpose of this question consider readability to be the only factor that matters
So I found this site that converts to easting ...
- 119
7
votes
1
answer
497
views
Common Methodologies for Writing "Post-Mortem" Reviews [closed]
We recently added a relatively large feature to our product that involved the entire R&D department (with all the different teams within it).
This feature included UI development, server side ...
- 171
0
votes
1
answer
3k
views
How to present code in academic work?
Actually, I'm writing my undergrad thesis, that consists in analysing the BitTorrent algorithm and see its application on Transmission client as an example of implementation.
Reading through its code,...
- 111
3
votes
3
answers
567
views
What is a good rule of thumb to do technical writing that doesn't confuse people
Sometimes I'm such a nerd that not even nerds understand me, or rather, sometimes I cannot put stuff in understandable and simple-enough terms... and sometimes I can but cannot really tell until after....
- 14k
7
votes
6
answers
735
views
Does long term programming affect writing in a native spoken languages? [closed]
So, I am getting some years under my belt in long term programming. I have noticed, however, when the frequency and duration started increasing in my coding sessions that when I actually went to ...
- 907
9
votes
2
answers
18k
views
Write a directory structure (pseudo code) [closed]
I am writing a wiki article and wondering what is the proper way to write a directory scheme?
I am doing something like
main folder
- sub folder
- sub folder
...
But I'm stuck after that.
Any help?
- 193
5
votes
2
answers
10k
views
Where can I find examples of functional specifications? [closed]
I am writing a functional specification for a software program (Mac OS X application to be exact). I want to improve this by looking at other (good) functional specifications, but I cannot find any.
...
user4595
2
votes
5
answers
605
views
Run On Sentences in Technical Writing
This is just a question to think about.
When you write technical documentation and programming comments, do you ever find yourself writing run-on sentences in order to be more precise?
Is packing ...
27
votes
8
answers
5k
views
How do you write technical blogs? [closed]
I usually read a lot about programming related stuff. When the topic I read is not related to my work directly ,(say reading about some Algorithms which I don't use in everyday work), I forget them.
...
- 15.7k
8
votes
4
answers
350
views
Programming in other writing systems such as those who write right-to-left
How do programmers in countries whose writing system is, say, right-to-left write their code? Say if they were using C# compiler, do they follow the left-to-right approach or do they have a different ...
- 263
23
votes
5
answers
12k
views
What grammatical tense should I write my specifications in?
We are currently writing functional and technical specifications in a two column format; summary sentence and technical detail. The details often refer to an appendix with diagrams, layout designs ect....
- 733