OpenAPI documentation rules

Namespace convention for Symfony bundles

Rule: All Symfony bundles MUST live in the LinkORB\Bundle\{BundleName}Bundle\ namespace.

Rationale: A single, predictable namespace makes bundles easy to autoload, discover and reference consistently across all LinkORB Symfony projects.

namespace LinkORB\Bundle\FooBundle;

use Symfony\Component\HttpKernel\Bundle\Bundle;

class FooBundle extends Bundle
{
    // ...
}

namespace LinkORB\FooBundle;

// `Bundle` is singular, not plural
namespace LinkORB\Bundles\FooBundle;

namespace FooBundle;

namespace Foo\Bundle\FooBundle;

Logging for Symfony projects

Rule: PSR-3 defines the PSR\Log\LoggerInterface, a standard for logging libraries.

Rationale: All Symfony apps should use the same approach for logging

Rule: PSR-3 must be implemented via Monolog

Rationale: Monolog is easy to install and use