Làm thế nào để tham khảo các phương pháp thể hiện trong tài liệu?

Question

Làm thế nào tôi có thể tham chiếu đến một trường thể hiện khi viết tài liệu?

xem xét mã này:

object Foo { 
    val foo = 42 
} 

class Foo { 
    val foo = 42 
} 

Trong Java, người ta sẽ sử dụng Foo.foo đối với phương pháp "tĩnh" và Foo#foo cho phương pháp dụ.

Nhưng trong Scala # đã được sử dụng với nhiều loại đường phụ thuộc và

class Foo { 
    class foo 
    def foo = 42 
} 

là mã quy phạm pháp luật, vì vậy tôi không thể đề cập đến nó một cách rõ ràng.

Có một số quy ước về điều này sẽ như thế nào?

Answer 1

Khó khăn. Có thể giống như tiếng Anh, như trong Foo's foo? Tôi đã bỏ lỡ sự mơ hồ của #. Đó vẫn là lựa chọn ưa thích của tôi, mặc dù, bởi vì sự mơ hồ chỉ tồn tại trong sự vắng mặt của bối cảnh. Khi đề cập đến một loại, # có một ý nghĩa. Khi đề cập đến một giá trị hoặc phương pháp, # có một giá trị hoặc phương pháp khác.

Vì các loại và phương pháp/giá trị không chia sẻ không gian tên nên tôi không thấy sự mơ hồ có liên quan ở đây.