Carey Brown wrote:Java API documentation is usually written as specially formatted text comments inserted into the Java code. A tool called javadocs will extract those comments and format them into indexed web pages. And, yes, a person actually had to write all that stuff.
Knute Snortum wrote:Welcome to the Ranch, Khaled!
You can read about how to write Java comments that become Javadocs here.
The enormous job of documenting a large system of programs becomes a little less daunting when each programmer takes the time to document their own code.
Knute Snortum wrote:Maybe an example will help:. . . .
Don't know. I was told that Oracle had hundreds of people working to develop this, but when they have finished one person will write the documentation.
Khaled Abolaynain wrote:. . . How many people work on a thing like that? . . .
Khaled Abolaynain wrote:When learning a new language, do I have to know every spec of the language? How do you decide you are ready for your next software project after learning Java? People say practice matters more than reading books and that's true. But when you learn the basics, head to your first project, for example, then stumble upon something you can’t find an answer for. Even if you find the answer, it may not be the optimal. You wouldn’t know the right tool for the job if you didn’t dig up what every tool (language spec) does.
No. You will never know all the specs, and if you ever do learn them, new specs will be developed. You should program with what you know, and gradually learn more. Nobody uses 1000 tools for anything. Learn how to use ten tools and use them. We have enough experience to recognise three different ways to do something:-
Khaled Abolaynain wrote:. . . . When learning a new language, do I have to know every spec of the language? . . . .
Khaled Abolaynain wrote:Maybe I should just focus on building something and stop overthinking about it!
Campbell Ritchie wrote:No. You will never know all the specs, and if you ever do learn them, new specs will be developed. You should program with what you know, and gradually learn more. Nobody uses 1000 tools for anything. Learn how to use ten tools and use them. We have enough experience to recognise three different ways to do something:-
1: The way I would do it. 2: A different correct way to do it. 3: A bad way to do it.Even now, beginners can hit on a new way to do things which we hadn't thought of.
Winston Gutkowski wrote:Ideally, you want to pick something that's just beyond your current capabilities, but not too far; otherwise you're likely to get frustrated. So, for example, if you haven't used databases yet, pick a reasonably simple task that uses a database to store information. Likewise with "webby" tools: start simple, and build up gradually.
Khaled Abolaynain wrote:I'm thinking about a web crawler. Wish me luck!