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/

Reply via email to