# Documentation **URL:** https://forum.soliditylang.org/c/documentation/8.md [Latest](https://forum.soliditylang.org/latest.md) · [Categories](https://forum.soliditylang.org/categories.md) --- ## [New communication channel about Solidity Docs Community Translations](https://forum.soliditylang.org/t/new-communication-channel-about-solidity-docs-community-translations/918)
**Author:** [@o-lenczyk](https://forum.soliditylang.org/u/o-lenczyk)\ **Replies:** 3\ **Last updated:** [March 24, 2025, 9:01am UTC](https://forum.soliditylang.org/t/new-communication-channel-about-solidity-docs-community-translations/918 "2025-03-24T09:01:35Z")
Hello everyone In case you do not know - we just opened a new matrix channel for translators: https://app.element.io/#/room/#solidity-docs-translations:matrix.org Currently, we are discussing Translation Bot for automa… --- ## [About the Documentation category](https://forum.soliditylang.org/t/about-the-documentation-category/17)
**Author:** [@franzihei](https://forum.soliditylang.org/u/franzihei)\ **Replies:** 0
Discussion about the documentation and its translations. :warning: Please do not use the forum to report issues (e.g. typos or broken links in the documentation). Please report issues directly via the Solidity Issue Tra… --- ## [Are there any efforts to improve or standardize translations of Solidity documentation?](https://forum.soliditylang.org/t/are-there-any-efforts-to-improve-or-standardize-translations-of-solidity-documentation/3693)
**Author:** [@alishawinson](https://forum.soliditylang.org/u/alishawinson)\ **Replies:** 2\ **Last updated:** [June 3, 2026, 2:58am UTC](https://forum.soliditylang.org/t/are-there-any-efforts-to-improve-or-standardize-translations-of-solidity-documentation/3693 "2026-06-03T02:58:36Z")
Hi everyone, I’ve been going through the official Solidity documentation and found it really well-structured, but I was wondering about its accessibility for non-English speakers. Are there any ongoing community efforts… --- ## [Localization of The Solidity Documentation](https://forum.soliditylang.org/t/localization-of-the-solidity-documentation/3708)
**Author:** [@hwhsu1231](https://forum.soliditylang.org/u/hwhsu1231)\ **Replies:** 0\ **Last updated:** [June 3, 2026, 2:51am UTC](https://forum.soliditylang.org/t/localization-of-the-solidity-documentation/3708 "2026-06-03T02:51:24Z")
Hello Solidity Community, I am the author of the Localize The Docs organization. And I’m glad to announce that the :tada: solidity-docs-l10n :tada: project is published now: :rocket: Preview: solidity-docs-l10n … --- ## [License and Attribution of the Solidity Logo?](https://forum.soliditylang.org/t/license-and-attribution-of-the-solidity-logo/3522)
**Author:** [@hwhsu1231](https://forum.soliditylang.org/u/hwhsu1231)\ **Replies:** 5\ **Last updated:** [October 27, 2025, 10:29am UTC](https://forum.soliditylang.org/t/license-and-attribution-of-the-solidity-logo/3522 "2025-10-27T10:29:42Z")
Hello, Solidity Team, I am the author of the localizethedocs organization, which focuses on manufacturing l10n projects for documentation of open-source projects. For example: cmake-docs-l10n, conan-docs-l10n, ros2-do… --- ## [Lack of centralized documentation of known vulnerabilities](https://forum.soliditylang.org/t/lack-of-centralized-documentation-of-known-vulnerabilities/3484)
**Author:** [@ciphermalware](https://forum.soliditylang.org/u/ciphermalware)\ **Replies:** 4\ **Last updated:** [October 20, 2025, 10:54am UTC](https://forum.soliditylang.org/t/lack-of-centralized-documentation-of-known-vulnerabilities/3484 "2025-10-20T10:54:09Z")
Hello there, The solidity docs are phenomenal, but it lacks a key feature, which is not having a dedicated category on the docs specific to Security. Under my humble point of view having a dedicated category that shows… --- ## [The key \`is\` annot be located in the keyword index of solidity documentation](https://forum.soliditylang.org/t/the-key-is-annot-be-located-in-the-keyword-index-of-solidity-documentation/3448)
**Author:** [@Facio](https://forum.soliditylang.org/u/Facio)\ **Replies:** 1\ **Last updated:** [July 13, 2025, 10:29am UTC](https://forum.soliditylang.org/t/the-key-is-annot-be-located-in-the-keyword-index-of-solidity-documentation/3448 "2025-07-13T10:29:03Z")
I wanted to advise of this, and also ask where I can find an exhaustive list of all keywords and terms used in solidity. The is keyword appears in the solidity grammar portion of the docs, but the keywords there are not… --- ## [Translations: Portuguese 🇵🇹 Coordination Thread](https://forum.soliditylang.org/t/translations-portuguese-coordination-thread/426)
**Author:** [@franzihei](https://forum.soliditylang.org/u/franzihei)\ **Replies:** 12\ **Last updated:** [September 7, 2024, 9:12pm UTC](https://forum.soliditylang.org/t/translations-portuguese-coordination-thread/426 "2024-09-07T21:12:30Z")
Hi guys! I realized some of you kicked off the Portuguese / Brazilian :portugal: :brazil: translations or are interested in supporting. Feel free to use this thread to coordinate if needed! --- ## [Precompiles should be in Docs](https://forum.soliditylang.org/t/precompiles-should-be-in-docs/2432)
**Author:** [@alexbabits](https://forum.soliditylang.org/u/alexbabits)\ **Replies:** 1\ **Last updated:** [August 2, 2024, 5:12am UTC](https://forum.soliditylang.org/t/precompiles-should-be-in-docs/2432 "2024-08-02T05:12:46Z")
I couldn’t find any references to the precompiled contracts in the docs. These are important/useful things to know that should be directly in the solidity language docs. --- ## [Docs: storage layout for array of arrays](https://forum.soliditylang.org/t/docs-storage-layout-for-array-of-arrays/2139)
**Author:** [@patarimannu](https://forum.soliditylang.org/u/patarimannu)\ **Replies:** 3\ **Last updated:** [February 6, 2024, 2:12pm UTC](https://forum.soliditylang.org/t/docs-storage-layout-for-array-of-arrays/2139 "2024-02-06T14:12:46Z")
Hello, everyone. I’m reading the storage layout docs and I’m puzzled by one of the closed formulas provided for the concrete example of an array uint24\[\]\[\] x. The docs say that the storage slot of element x\[i\]\[j\] is ke… --- ## [Question about IR semantic changes](https://forum.soliditylang.org/t/question-about-ir-semantic-changes/2022)
**Author:** [@0xlgtm](https://forum.soliditylang.org/u/0xlgtm)\ **Replies:** 1\ **Last updated:** [December 19, 2023, 3:55pm UTC](https://forum.soliditylang.org/t/question-about-ir-semantic-changes/2022 "2023-12-19T15:55:59Z")
Hi all, apologies in advance if this is not the right place to ask this. If so, please let me know the more appropriate channel to ask these questions. I was reading through Solidity IR-based Codegen Changes — Solidity… --- ## [Implicit hexadecimal literal to string conversion](https://forum.soliditylang.org/t/implicit-hexadecimal-literal-to-string-conversion/1826)
**Author:** [@rahul](https://forum.soliditylang.org/u/rahul)\ **Replies:** 2\ **Last updated:** [September 1, 2023, 11:18am UTC](https://forum.soliditylang.org/t/implicit-hexadecimal-literal-to-string-conversion/1826 "2023-09-01T11:18:39Z")
From the official docs: Hexadecimal literals in some ways behave like string literals but are not implicitly convertible to the string type. Source: https://docs.soliditylang.org/en/v0.8.21/types.html#hexadecimal-lit… --- ## [\[Documentation\] Conversion from payable to contract type](https://forum.soliditylang.org/t/documentation-conversion-from-payable-to-contract-type/1820)
**Author:** [@rahul](https://forum.soliditylang.org/u/rahul)\ **Replies:** 7\ **Last updated:** [August 31, 2023, 5:45am UTC](https://forum.soliditylang.org/t/documentation-conversion-from-payable-to-contract-type/1820 "2023-08-31T05:45:42Z")
Solidity docs states “Explicit conversion to and from the address payable type is only possible if the contract type has a receive or payable fallback function.” However, I am able to explicitly convert address payable … --- ## [How to know about minimum and maximum values of Types in the documentation](https://forum.soliditylang.org/t/how-to-know-about-minimum-and-maximum-values-of-types-in-the-documentation/1771)
**Author:** [@w3bee](https://forum.soliditylang.org/u/w3bee)\ **Replies:** 5\ **Last updated:** [August 10, 2023, 7:11pm UTC](https://forum.soliditylang.org/t/how-to-know-about-minimum-and-maximum-values-of-types-in-the-documentation/1771 "2023-08-10T19:11:40Z")
Is it only me that can’t learn the maximum value of uint16 for example- simply from the documentation, or the documentation didn’t see this information as a necessity to be included? Like it is universal standard of type… --- ## [Translation: Hebrew](https://forum.soliditylang.org/t/translation-hebrew/1676)
**Author:** [@ChefAharoni](https://forum.soliditylang.org/u/ChefAharoni)\ **Replies:** 4\ **Last updated:** [August 7, 2023, 2:06am UTC](https://forum.soliditylang.org/t/translation-hebrew/1676 "2023-08-07T02:06:44Z")
Hello everyone, I’m originally in Israel and currently live in the US. Any other Hebrew native speakers here that want to help me translate the documentations to Hebrew? --- ## [Understanding the "memory-safe" dialect](https://forum.soliditylang.org/t/understanding-the-memory-safe-dialect/1481)
**Author:** [@paulrberg](https://forum.soliditylang.org/u/paulrberg)\ **Replies:** 5\ **Last updated:** [July 19, 2023, 4:59pm UTC](https://forum.soliditylang.org/t/understanding-the-memory-safe-dialect/1481 "2023-07-19T16:59:04Z")
I read the assembly docs but I am still a bit unsure regarding when I should apply the ("memory-safe") dialect, and when not. For instance, take the following examples taken from PRBMath: function frac(UD60x18 x) pure … --- ## [Type representation of literals](https://forum.soliditylang.org/t/type-representation-of-literals/1697)
**Author:** [@0xalpharush](https://forum.soliditylang.org/u/0xalpharush)\ **Replies:** 1\ **Last updated:** [June 23, 2023, 9:01am UTC](https://forum.soliditylang.org/t/type-representation-of-literals/1697 "2023-06-23T09:01:05Z")
In the solidity docs, it says literal are represented as their smallest mobile type but it seem different for shift left than arithmetic operators e.g. the following results in below error message but it works fine as 1 … --- ## [I want to help translate to Russian/Ukrainian](https://forum.soliditylang.org/t/i-want-to-help-translate-to-russian-ukrainian/1616)
**Author:** [@aborriginal](https://forum.soliditylang.org/u/aborriginal)\ **Replies:** 4\ **Last updated:** [April 19, 2023, 1:47pm UTC](https://forum.soliditylang.org/t/i-want-to-help-translate-to-russian-ukrainian/1616 "2023-04-19T13:47:54Z")
Hello! I am learning Solidity with CryptoZombies and came here from GitPOAP project. I am native Russian/Ukrainian speaker. So I want to contribute to hit two targets: 1) learn Solidity and 2) Get GitPOAP. Is there need … --- ## [Wording about function types in documentation](https://forum.soliditylang.org/t/wording-about-function-types-in-documentation/1500)
**Author:** [@Drblessing](https://forum.soliditylang.org/u/Drblessing)\ **Replies:** 2\ **Last updated:** [March 18, 2023, 10:04pm UTC](https://forum.soliditylang.org/t/wording-about-function-types-in-documentation/1500 "2023-03-18T22:04:07Z")
Link “Variables of function type can be assigned from functions and function parameters of function type can be used to pass functions to and return functions from function calls.” Could this potentially be made cleare… --- ## [Storage object JSON interface](https://forum.soliditylang.org/t/storage-object-json-interface/378)
**Author:** [@maxareo](https://forum.soliditylang.org/u/maxareo)\ **Replies:** 7\ **Last updated:** [January 19, 2023, 7:55pm UTC](https://forum.soliditylang.org/t/storage-object-json-interface/378 "2023-01-19T19:55:22Z")
Hi there, on PG 168, 3.14.2 JSON Output section about storage layout of a contract, the sample given has “slot” and “offset” fields, however, I checked local folders from Hardhat and found no JSON files containing such i… --- ## [Documentation question about solidity state variable storage layout](https://forum.soliditylang.org/t/documentation-question-about-solidity-state-variable-storage-layout/1245)
**Author:** [@xinbenlv](https://forum.soliditylang.org/u/xinbenlv)\ **Replies:** 3\ **Last updated:** [October 4, 2022, 3:15pm UTC](https://forum.soliditylang.org/t/documentation-question-about-solidity-state-variable-storage-layout/1245 "2022-10-04T15:15:37Z")
Hi gurus, I have a question about solidity state variable storage layout. Does anyone know where in the solidity compiler can I find the reference to these two piece of code that determines the slot index of dynamically… --- ## [The mapping value storage location](https://forum.soliditylang.org/t/the-mapping-value-storage-location/1198)
**Author:** [@maxareo](https://forum.soliditylang.org/u/maxareo)\ **Replies:** 0\ **Last updated:** [August 20, 2022, 7:46am UTC](https://forum.soliditylang.org/t/the-mapping-value-storage-location/1198 "2022-08-20T07:46:48Z")
In the solidity doc, the following sentence is written to describe the slot location in storage of a mapped value given the key. It is a bit abstract and the . operator, which is said to be concatenation, can be made mor… --- ## [How do these mathematical symbols work? == and ++ vs = and +](https://forum.soliditylang.org/t/how-do-these-mathematical-symbols-work-and-vs-and/752)
**Author:** [@FloatingAtSea](https://forum.soliditylang.org/u/FloatingAtSea)\ **Replies:** 1\ **Last updated:** [August 13, 2022, 8:21am UTC](https://forum.soliditylang.org/t/how-do-these-mathematical-symbols-work-and-vs-and/752 "2022-08-13T08:21:47Z")
Hello everyone, I am currently learning solidity (beginner) and I do not understand = and ==, as well as + and ++, and the meaning of \[ \] and ( ). I use them in my training but I do not completely know how to read them I… --- ## [Introducing the Translations PR Bot! 🤖](https://forum.soliditylang.org/t/introducing-the-translations-pr-bot/1115)
**Author:** [@franzihei](https://forum.soliditylang.org/u/franzihei)\ **Replies:** 4\ **Last updated:** [July 22, 2022, 9:54pm UTC](https://forum.soliditylang.org/t/introducing-the-translations-pr-bot/1115 "2022-07-22T21:54:50Z")
The time has come to finally merge the long awaited Translations PR Bot! If you haven’t been following the process so far, here is a bit of context: To help the community organize the community translation efforts in … --- ## [Translations: Turkish Coordination🇹🇷](https://forum.soliditylang.org/t/translations-turkish-coordination/1084)
**Author:** [@AliErcanOzgokce](https://forum.soliditylang.org/u/AliErcanOzgokce)\ **Replies:** 8\ **Last updated:** [June 23, 2022, 8:52pm UTC](https://forum.soliditylang.org/t/translations-turkish-coordination/1084 "2022-06-23T20:52:08Z")
Hello everyone, I’m looking for contributors to translate the documents into Turkish. We can create a community for this. If you’re interested to contribute please let me know. --- ## [Uni Directional Payment](https://forum.soliditylang.org/t/uni-directional-payment/1067)
**Author:** [@porscheTan](https://forum.soliditylang.org/u/porscheTan)\ **Replies:** 1\ **Last updated:** [June 15, 2022, 5:21pm UTC](https://forum.soliditylang.org/t/uni-directional-payment/1067 "2022-06-15T17:21:04Z")
Dear All Smart Contract Developers, I am an amateur in this space and would greatly appreciate your help in helping me understand certain concepts from this documentation (Uni-Directional Payment Channel). In this docu… --- ## [Translations: Spanish Coordination 🇪🇸](https://forum.soliditylang.org/t/translations-spanish-coordination/736)
**Author:** [@elijahhampton](https://forum.soliditylang.org/u/elijahhampton)\ **Replies:** 11\ **Last updated:** [May 27, 2022, 11:33am UTC](https://forum.soliditylang.org/t/translations-spanish-coordination/736 "2022-05-27T11:33:31Z")
Hello everyone. I’m looking at the translation repositories for solidity docs and noticed there is not one for Spanish. The Spanish speaking community is a large part of the Ethereum community and I would love to get d… --- ## [Translations: Polish Coordination 🇵🇱](https://forum.soliditylang.org/t/translations-polish-coordination/1032)
**Author:** [@mtbcoin](https://forum.soliditylang.org/u/mtbcoin)\ **Replies:** 0\ **Last updated:** [May 22, 2022, 10:49pm UTC](https://forum.soliditylang.org/t/translations-polish-coordination/1032 "2022-05-22T22:49:52Z")
Looking for contributors. Some chapters are already translated in mtbcoin/solidity-docs-pl repository on GitHub. Just learning Solidity this way and helping the community. Once we find at least 2 contributors, we will se… --- ## [Translations: How can I contribute? (ko)](https://forum.soliditylang.org/t/translations-how-can-i-contribute-ko/993)
**Author:** [@miak](https://forum.soliditylang.org/u/miak)\ **Replies:** 5\ **Last updated:** [April 28, 2022, 2:44pm UTC](https://forum.soliditylang.org/t/translations-how-can-i-contribute-ko/993 "2022-04-28T14:44:06Z")
Hello everyone, I have created PR a week ago, but not sure if it is being reviewed. I could have done something wrong because this is my first time contributing open source - maybe because I translated only half of the… --- ## [Should the Solidity docs give some guidance on naming conventions?](https://forum.soliditylang.org/t/should-the-solidity-docs-give-some-guidance-on-naming-conventions/924)
**Author:** [@paulrberg](https://forum.soliditylang.org/u/paulrberg)\ **Replies:** 2\ **Last updated:** [March 31, 2022, 4:12pm UTC](https://forum.soliditylang.org/t/should-the-solidity-docs-give-some-guidance-on-naming-conventions/924 "2022-03-31T16:12:16Z")
Some modern languages like Rust give specific recommendations on naming conventions. It is sort of an unofficial community standard in Solidity to use camelCase for function names. Should we officialize this by mentioni… [Next page](https://forum.soliditylang.org/c/documentation/8.md?page=1)