You can create a patch for a new doc/specs/idl.md and I will integrate
that into the web page as well.
-roger
Quoting "Jeremy W. Sherman" <[email protected]>:
Hi there,
https://thrift.apache.org/docs/idl#namespace contains this snippet:
N.B.: Smalltalk has two distinct types of namespace commands. Can
someone who knows Smalltalk explain why Smalltalk needs two
different kinds of namespaces?
It doesn't look like this page's content is in the git repo, so how
does one go about updating the page?
The answer is:
===BEGIN===
- smalltalk.prefix: Smalltalk does not have namespaces for classes,
so prefixes are used to manually namespace classes to avoid
class-name collisions. This allows distinguishing, say, JWSGame from
KBGame. Utility code often uses the author's initials as the prefix;
application or library code is likely to use a prefix representing a
shortened version of the name of the app/library.
- smalltalk.category: Smalltalk allows filing methods within a class
into named groups. These named groups of methods are called
categories. They let you group methods together for easier browsing.
For example, TextEditor instance methods are partitioned into
categories like accessing, accessing-selection, displaying, menu
messages, parenblinking, etc.
In terms of Thrift, the smalltalk.prefix would likely abbreviate the
name of the service or company. Likely candidates for
smalltalk.category are "Thrift" and "RPC".
===END===
Now, how do I go about getting this explanation into the docs?
Aside: Objective-C supports the same forms of namespacing, so that
its codegen could theoretically also use these properties.
Cheers,
--
Jeremy W. Sherman
https://jeremywsherman.com/
