yeah its one of the more weird conventions of sphinx that you can use many different characters and the logic is just per file to start from first level down. having the same convention as symfony core certainly will help. this is not explained in the symfony doc docs explicitly?