I describe the software architecture, I write there that I use System.Cryptography for encoding and decoding. So, can I write this: "The Cryptography library is used." I think not, but how then is it better to call it?

    4 answers 4

    Namespaces are usually consistent with the assembly, in particular, it is assumed that the System.Security assembly just contains the types from the System.Security.Cryptography . But usually it does not always mean, and in this case it is not so: some of the objects from System.Security.Cryptography defined in mscorlib , some in System.Core and some in System.Security .

    An assembly is either in an executable file (.EXE) or in a dynamically linked library (.DLL). Therefore, strictly speaking, if you are writing about a library , you must specify a specific assembly, for example, mscorlib.dll , System.Core.dll or System.Security.dll .

    You can not go into details, and write that you are using the standard cryptographic tools. NET Framework, which is true and will tell the knowledgeable person what this is about.

    However, usually this section of the documentation should tell you exactly which cryptographic tools you use now and whether they can be changed as they become obsolete. Therefore, you can refer to the names of the algorithms, good, all the popular algorithms in the .NET Framework are implemented.

      Write that for encoding and decoding the class is used. Название конкретного класса, который вы используйте from the System.Security.Cryptography (provided that this class is from this namespace). The Используется библиотека Cryptography will be confusing, because a person might think about some kind of external library.

      • Well, in general, this phrase will be correct, let's say a person knows that the namespace is assumed? - Alexander Semikashev
      • If you write documentation, your goal is to clearly and intelligibly convey the necessary information to the user. Therefore, specifying the name of the class and namespace will allow you to more precisely specify what you mean. Because classes with the same name can be located in different namespaces. - sp7

      No, the namespace cannot be called a library.

      Look in the documentation or in the studio for the name of the assembly where the classes you use are located - this will usually be the name of the library. Most likely, you are using System.dll or System.Security.dll .

      But in your case it is easier to say “standard .NET Framework libraries”.

        System.Security.Cryptography The namespace provides cryptographic services for securely encrypting and decrypting data, as well as many other operations, such as hashing, random number generation, and message authentication

        • I know what is it. The question is different ... - Alexander Semikashev