.NET Core project does not include all the important file

[ravichandrasingh]

How can I generate documentation for all the files in a .NET Core project?

I've noticed that often the documentation doesn't include all methods and properties of the classes (.cs files).
Also, when the generation process breaks partway through, it restarts from the beginning next time instead of resuming from where it left off. This causes it to use more tokens and makes it more costly.

How can I include the all-important class (.cs file) to generate the document?

Some case if class has more than 10 methods, code generate only the one or two method's document and leaving the rest out and including a note in the documentation like "// ... many more remaining methods and properties ..."

Please help me with the issue described above so that I can generate documentation for my entire .NET Core project effectively.

[zachary62]

How can I include the all-important class (.cs file) to generate the document?

Update the --include to include all files you want

python main.py --dir /path/to/your/codebase --include "*.cs"

Some case if class has more than 10 methods, code generate only the one or two method's document and leaving the rest out and including a note in the documentation like "// ... many more remaining methods and properties ..."

Yeah this is expected. It try to skip redundant methods.

PocketFlow-Tutorial-Codebase-Knowledge/nodes.py

Line 706 in 755e767

- Each code block should be BELOW 10 lines! If longer code blocks are needed, break them down into smaller pieces and walk through them one-by-one. Aggresively simplify the code to make it minimal. Use comments{code_comment_note} to skip non-important implementation details. Each code block should have a beginner friendly explanation right after it{instruction_lang_note}.

You can update the instruction.

[ravichandrasingh]

@zachary62 Thanks for your response.

I’ve already made the necessary changes, but not all .cs files are being included in the generated documentation.

[zachary62]

@zachary62 Thanks for your response.

I’ve already made the necessary changes, but not all .cs files are being included in the generated documentation.

Maybe it's because of the EXCLUDE? Could you also try to tune these?

[ravichandrasingh]

Hi @zachary62 ,

I’ve already fine-tuned the exclude patterns to filter out irrelevant files and folders such as bin, obj, .git, .gitignore, .vs, test, and other non-essential directories.
For your information, the codebase contains around 80–90 important abstractions, but the documentation generator only captures about 15–20 of them, leaving the majority unprocessed.

[zachary62]

You can tune the # abstractions using:

PocketFlow-Tutorial-Codebase-Knowledge/main.py

Lines 57 to 58 in 755e767

	# Add max_abstraction_num parameter to control the number of abstractions
	parser.add_argument("--max-abstractions", type=int, default=10, help="Maximum number of abstractions to identify (default: 10)")

[ravichandrasingh]

already done!

And also update in the class "IdentifyAbstractions"

and pass the max-abstractions as below at run time.

python main.py --dir {projcet location} --max-size 10000 --max-abstractions 200 --output ./output/Test