Re: [Bf-committers] Change in code style guideline: location of documentation

2021-11-22 Thread Sybren A . Stüvel via Bf-committers
On Sat, 20 Nov 2021 at 05:26, Campbell Barton wrote: > > Please note that this is not a proposal to immediately start modifying > all > > of Blender's sources to put the docs in their new location. > > This sounds like header files not ending up as a good central > reference for API's (which is o

Re: [Bf-committers] Change in code style guideline: location of documentation

2021-11-19 Thread Campbell Barton via Bf-committers
On Tue, Nov 16, 2021 at 9:03 PM Sybren A. Stüvel via Bf-committers wrote: > > Hi all, > > Recently there has been a discussion about the location of code > documentation (as in, the in-source documentation comments). The gist of it > is that, in my opinion, documentation of the public interface of