Source code is any collection of computer instructions (possibly with comments) written using some human-readable computer language, usually as text.

learn more… | top users | synonyms (1)

23
votes
9answers
2k views

How should I go about learning a very large and complex application? [duplicate]

Being a young and fairly inexperienced developer recently employed by a "real" software company I'd like some opinions and pointers on how to do the following: Approaches on how to get familiar with ...
18
votes
16answers
2k views

How do you go about understanding others' code? [closed]

What do you do to understand some code that you didn't write? Or code that you wrote long time ago and don't remember what it does anymore. Do you have some technique that you go about? Do you ...
22
votes
12answers
2k views

How do people manage to write and maintain extremely complex and hard to read code? [closed]

Reading SQLite source code is IMO mission impossible. Yet it is a usable piece of quite complex software (it's a full-blown embedded database after all) that can be downloaded, compiled and used from ...
8
votes
6answers
2k views

Is it necessary to write a javadoc comment for EVERY parameter in a method's signature?

One of the devs on my team believes that it is necessary to write a javadoc comment for EVERY parameter in a method's signature. I do not think this is necessary, and in fact I think it can even be ...
60
votes
13answers
8k views

Can commented-out code be valuable documentation?

I wrote the following code: if (boutique == null) { boutique = new Boutique(); boutique.setSite(site); boutique.setUrlLogo(CmsProperties.URL_FLUX_BOUTIQUE+fluxBoutique.getLogo()); ...
58
votes
14answers
8k views

How to prevent code from leaking outside work? [duplicate]

Possible Duplicate: How to manage a Closed Source High-Risk Project? I'm working on an institution that has a really strong sense of "possession" - each line of software we write should be ...
21
votes
5answers
2k views

Is code ownership a code smell?

This is something I've been thinking about ever since I read this answer in the controversial programming opinions thread: Your job is to put yourself out of work. When you're writing ...
14
votes
18answers
3k views

How to read thousands lines of code without any documentation?

Previously I was searching for a good TimeLine control for a WPF project. I found an answer in Here which direct me to this CodePlex project. Now I want to change code to feed my culture needs. But ...
21
votes
10answers
5k views

Hand over source code to customer

I have made a couple iphone applications for a customer and was asked today to hand over the source code so that they could do the maintenance if this should be required. Until now, no code issues ...
12
votes
5answers
908 views

Time required to start coding at a new company [closed]

I am a software engineer for 4 years, and I just changed my company for the first time. Company works with pair programming, and it's been 3 days, I couldn't even write a single line of code. It's so ...
8
votes
2answers
665 views

Updating copyright headers each new year just because Jan 1st has passed? [duplicate]

I've seen some projects that - with each new year - start to change all files in their source-tree to update the copyright year. Isn't this just pushing hot air on a level of magnitude? AFAIK: ...
7
votes
3answers
350 views

How do you find your way in deeply nested, interfacey code? [duplicate]

I know most people hate flat and long functions, and hate when code is not full of ISomethings. The problem is that I guess my mind works in different way, and I always have problems with that type ...
194
votes
23answers
33k views

Should you keep a copy of all the code you write?

I know the company you work for owns the code and obviously you will get arrested if you try to sell it. But is it uncommon for developers to keep a personal copy of the code they wrote (for future ...
12
votes
7answers
7k views

What are some good open source c++ packages to study in order to learn advanced software construction? [closed]

I've heard that you should read 10 times more than you should write. This applies to both literature and source code. Therefore, I'd like to study the best c++ packages we've developed. I'm ...
35
votes
5answers
7k views

Where do you go to read good examples of source code? [closed]

I have heard a few people say that one of the best ways to improve your coding ability is to read others code and understand it. My question, as a relatively new programmer, where do I go to find ...
32
votes
5answers
2k views

Are there any actual case studies on rewrites of software success/failure rates?

I've seen multiple posts about rewrites of applications being bad, people's experiences about it here on Programmers, and an article I've ready by Joel Spolsky on the subject, but no hard evidence or ...
17
votes
10answers
8k views

Understanding already existing complex code base [duplicate]

Possible Duplicate: What is the most effective way to add functionality to unfamiliar, structurally unsound code? Till now, all I have worked on is with Java projects that I build from ...
51
votes
10answers
7k views

When is code “legacy”? [closed]

We've all done it, we've labelled some code (often stuff we've inherited) as "legacy"? But it's still used in the production systems - so is it really legacy? And what makes it legacy? Should we shy ...
36
votes
14answers
3k views

Do you sign each of your source files with your name? [duplicate]

Possible Duplicate: How do you keep track of the authors of code? One of my colleagues is in the habit of putting his name and email address in the head of each source file he works on, as ...
11
votes
6answers
802 views

Development Approach: User Interface In or Domain Model Out?

While I've never delivered anything using Smalltalk, my brief time playing with it has definitely left its mark. The only way to describe the experience is MVC the way it was meant to be. ...
17
votes
11answers
1k views

“// …” comments at end of code block after } - good or bad?

I've often seen such comments be used: function foo() { ... } // foo while (...) { ... } // while if (...) { ... } // if and sometimes even as far as if (condition) { ... } // if ...
8
votes
11answers
2k views

Version control comments - past or present tense

For version control comments what do other users do/recommend - past or present tense? I.e. Changed x to be y. or Changing x to be y.
3
votes
3answers
3k views

How to show code samples in an interview?

There have been questions similar to this, but my question is HOW exactly do you showcase your code when going to an interview? Do you show screenshots, or do you bring the actual code? Do you take ...
10
votes
7answers
2k views

Freelancing - Share the source code? [duplicate]

Possible Duplicate: Hand over source code to customer I have developed a couple of form based windows application in vb.net for a client and they all work well and he paid me through a ...
3
votes
4answers
931 views

Is Googling every code a bad practice? [duplicate]

I just came from an interview in which they asked me several questions about programming and problem solving. Regarding the programming questions, I asked them to let me Google so I can see the code ...
212
votes
15answers
23k views

How can a code editor effectively hint at code nesting level - without using indentation?

I've written an XML text editor that provides 2 view options for the same XML text, one indented (virtually), the other left-justified. The motivation for the left-justified view is to help users ...
82
votes
17answers
4k views

How do you cope with ugly code that you wrote?

So your client asks you to write some code, so you do. He then changes the specs on you, as expected, and you diligently implement his new features like a good little lad. Except... the new features ...
45
votes
22answers
10k views

What are some good practices before checking in source code?

My team uses Team Foundation Server for source control, and today I fixed some bugs and smoke test application before I checked it in but I forgot to comment some code. (This code made the UI a little ...
17
votes
5answers
3k views

How do I understand an open source project code?

I open the source code and it's folder upon folder of infinite files each with infinite lines of code which doesn't make much sense to me because I dont have the context, and half of it uses functions ...
23
votes
14answers
5k views

Dealing with profanity in source code

How do people deal with profanity in source code and VCS comments. Keep or delete? What about soft-expletives like WTF or Arrgggh? Is unprofessional, offensive or something to be shrugged off?
20
votes
4answers
6k views

Classes naming: singular or plural?

It is always difficult for me to choose between singular and plural forms for classes names: CustomerRepository vs. CustomersRepository CustomerService vs. CustomersService CustomerController vs. ...
14
votes
7answers
4k views

How do you read other's code? [closed]

Almost every advanced programmer says that it's very useful to read the code of other professionals. Usually they advice open source. Do you read it or not? If you do, how often and what's the ...
20
votes
5answers
917 views

How-to convince company to start documenting for legacy software [duplicate]

It has been less than a year since I joined my current company. Their majority of sales have come from a single product that has been alive since the last 10 years. However, there is minimal (if at ...
17
votes
3answers
2k views

Must source code released under GPL be human-readable?

In a response to another question, a poster suggested that under the GPL: ...you need to provide the human readable [code], not a whitespace stripped version... Readability would seem to me to ...
2
votes
2answers
312 views

Writing/discussions about the aesthetics of code? [closed]

I'm looking for considerations of the questions "Can code be beautiful?" and "What makes code beautiful?" Examples would include: This academic paper: Obfuscation, Weird Languages, and Code ...
9
votes
3answers
960 views

Are there code reviews in opensource projects? If so, what tools are used to do this?

I know there is a big push for code reviews in commercial development. However, are code reviews used in open source software or is based on trust? If so, then how are they performed? [Is it a delayed ...
8
votes
3answers
1k views

Quantifying the price for source code and software product

I'm about to undertake a project. This requires me to write code, and tons of it. The client's requirement is to hand in all source code at the end of the project. My question is: How do I quantify ...
8
votes
7answers
2k views

Is “send us a page with code” a typical interview requirement? [closed]

Recently I was asked to show "a page with code" for a job interview. Being mainly a back-end programmer, and that's the position I applied for, I first said to the person I was talking to exactly ...
8
votes
5answers
1k views

What to do with bad source code? [duplicate]

I have been contracted to modify an application for a software company and the source code is quite frankly, a mess. It's not commented much and the author is inconsistent with coding conventions. The ...
5
votes
0answers
237 views

What to do when tackling an unfamiliar Code base? [duplicate]

Possible Duplicate: How do you dive into large code bases? When you join a pre-existing project that has a large code base, what are some of the things you do to get acclimatized quickly ...
2
votes
2answers
226 views

Is virtual machine image a good protection for source code?

We have developed an application that is sold as an online service. After some time we realized that some of customers would need/prefer/require to have it installed locally on their intranet. However ...
3
votes
2answers
338 views

Is there a name for being able to quickly find the relevant code? [closed]

I notice that a property of codebases that I like hacking on is that it's quick to find the relevant code for some feature, without knowing much about the code base at all. For example, searching for ...
3
votes
3answers
435 views

Code bases for desktop and mobile versions of the same app

I have written a small Java Swing desktop application. It seems like a natural step to port it to Android since I am interested in learning how to program for that platform. I believe that I can reuse ...
3
votes
4answers
3k views

GPL Confusion! Can I sell a product with GPL covered components without making the source available?

I'm really confused.. I'm looking into making a commercial program and there are a few open source, GPL covered components i'd like to use.. Am I allowed to sell my product with the components in ...
0
votes
1answer
867 views

Big project with many external libraries - source code organisation

I was wondering what is the best way to organize my source code. I was researching on SO and found http://stackoverflow.com/a/1398594/137261 but this source code layout is library specific and doesn't ...