[ / / / / / / / / / / / / / ] [ dir / 2hu / asmr / fur / htg / hypno / ita / sonyeon / strek ][Options][ watchlist ]

/prog/ - Programming

Programming board
You can now write text to your AI-generated image at https://aiproto.com It is currently free to use for Proto members.
Name
Email
Subject
Comment *
File
Select/drop/paste files here
* = required field[▶ Show post options & limits]
Confused? See the FAQ.
Expand all images

[–]

3132c3 (3) No.4847>>4861 [Watch Thread][Show All Posts]

I'm not entirely sure how to call what I'm looking for, but I'm wondering how you go about organizing your thoughts and your notes as you plan and expand upon a project. Projects fast reach a size where keeping all of that structure in your head is an excessive mental burden or outright impossible, I'm realizing, especially if you take a break from them.

Right now I have: a title, a brief description, a mass of loosely-organized notes, and a bunch of semi-documented code in an alpha state. What I want to do is to take that description and elaborate on it iteratively so as to tease out the main features or components of the program, giving myself a better overview of its current state and where it's heading, and helping me to organize all those notes more effectively. This has proved easier said than done, however, and I'm wondering if there are any formalized methods or insights into this process which could prove helpful.

A little googling and a skim of the tables of contents of both HTDP and SICP didn't turn up anything promising; it seems as if everyone who sets out to teach you how to program gets right down into the nitty gritty of data structures and coding exercises awfully quickly, but even if you prefer to start your project at that level you have to return to the design phase before long. I would be grateful for anything to point me in the right direction.

3132c3 (3) No.4851

In case anyone's interested, after thinking about this some more I've concluded that a good piece of diagramming software is the answer and settled on yEd.


03312a (1) No.4854>>4855

If you feel you need UML or something your design might just be horrible. Pick something like Clean Architecture and stick with it. GitHub repositories have "projects" which are Kanban boards that should be absolutely sufficient in keeping you up to date on what you were working on, are working on or need to be working on. If that is your problem


3132c3 (3) No.4855

>>4854

I'll give Clean Architecture a look, thanks. I looked at Kanban before making this thread but it's really more for time management, which isn't what I need.

After using it more I've realized yEd, being just for diagramming, doesn't offer any facility to represent, organize and interrelate notes or concepts with one another or with elements of a diagram. I looked into mind-mapping software but it, unsurprisingly, doesn't offer the diagramming features I want to actually model the software. It seems like what I'm looking for is something between the two, which I don't think I'm going to find. Maybe what I really need is to learn more about software architecture; no doubt Uncle Bob will prove illuminating.


3cbc18 (1) No.4861

>>4847 (OP)

I've used draw.io before, especially in cases where I've had to work with databases where the foreign key links weren't defined in SQL to keep track of how all the database link together.

Normally I don't have the entirety of a project's code in my head, I just know how the program is supposed to work and the code to the part I'm currently working on. The most important thing for me is to comment complicated code and to use good variable names so that when I return to a part of a program that I haven't worked on in a long time that I can figure it out again quickly.

I also have a white board in my office, but I tend to use it for writing lists of things I have not done yet.




[Return][Go to top][Catalog][Screencap][Nerve Center][Cancer][Update] ( Scroll to new posts) ( Auto) 5
4 replies | 0 images | 3 UIDs | Page ???
[Post a Reply]
[ / / / / / / / / / / / / / ] [ dir / 2hu / asmr / fur / htg / hypno / ita / sonyeon / strek ][ watchlist ]