Should you place BDD and IBDs within the block or in a separate folder?

[mse]

I'm trying to decide how to best organize my diagrams. Some methodologies have you separate your diagrams into a package like "Block Definitino Diagrams" while others especially in EA tend to create diagrams within the block itself. What is best especially if I'm trying to generate documentation from the model?

Things work fine when I have the diagram under the package at the same level as the block, but once there is a diagram under the block, then it gets a little more tricky when setting up the .rtf report template. While I can get the diagram to output in the RTF it is a bit confusing to know where I'm at in the hierarchy with child packages, blocks, then subpackages, etc.

[natvig]

You should definitely place internal block diagrams within the block itself. There are many benefits which this approach, there is simply no other way. Yes, documentation can be a little tricky, especially if I have multiple ibd:s within a block. How can you output elements from one diagram at a time in this case? I have had success doing it with document scripts following this guide: https://zubkiewicz.com/nonlinear-generation-of-documentation-in-sparx-enterprise-architect/

Block definition diagrams on the other hand is normally not placed within a block, but can be in some special cases. One example is the diagram 7.10 in the book A Practical Guide to SysML (second edition). There you see the diagram header bdd [block] Camera (Power Subsystem) which indicates that the context for the diagram is a block which indicates that the diagram can be placed under the block itself.