6dd33fb8f7
Major changes due to JDK 17: 1. JDK17 JCE Provider now has built-in support for eddsas, corda uses the bouncycastle (i2p) implementation. This PR removes the conflicting algorithms from the built-in JCE provider. 2. JavaScript scripting has been removed from the JDK, the corda log4j config was using scripting to conditionally output additional diagnostic info if the MDC was populated. This PR has removed the scripting. 3. The artifactory plug-ins used are now deprecated, this PR has removed them and uses the same code as Corda 5 for publishing to artifactory. 4. Javadoc generation has been modified to use the latest dokka plug-ins. 5. Gradle 7.6 has implemented an incredibly annoying change where transitive dependencies are not put on the compile classpath, so that they have to be explicitly added as dependencies to projects. 6. Mockito has been updated, which sadly meant that quite a few source files have to changes to use the new (org.mockito.kotlin) package name. This makes this PR appear much larger than it is. 7. A number of tests have been marked as ignored to get a green, broadly they fall into 3 classes. The first is related to crypto keypair tests, it appears some logic in the JDK prefers to use the SunJCE implementation and we prefer to use bouncycastle. I believe this issue can be fixed with better test setup. The second group is related to our use of a method called "uncheckedCast(..)", the purpose of this method was to get rid of the annoying unchecked cast compiler warning that would otherwise exist. It looks like the Kotlin 1.9 compiler type inference differs and at runtime sometimes the type it infers is "Void" which causes an exception at runtime. The simplest solution is to use an explicit cast instead of unchecked cast, Corda 5 have removed unchecked cast from their codebase. The third class are a number of ActiveMQ tests which appear to have a memory leak somewhere. |
||
|---|---|---|
| .. | ||
| example-code | ||
| whitepaper | ||
| .gitattributes | ||
| .gitignore | ||
| build.gradle | ||
| README.md | ||
Docs
Released documentation
All released Corda documentation has now been moved to a standalone public documentation repository where the doc source can be found:
See the readme and usage docs pages for instructions on how to use the new repo and build the docs locally.
You can contribute to the docs source as before via fork & PR. We now use markdown to write/edit (instead of rst) and Hugo to build (instead of Sphinx).
The published documentation is available at https://docs.corda.net.
Documentation for future releases
R3's technical writing team, R3 engineering, and other R3 teams use a separate, private docs repo for working on draft documentation content targeting future releases:
These docs are published as part of each quarterly release of Corda. At that point their doc source becomes available and open for contributions in the public docs repo.
The new documentation process is described in the technical writing team's space on R3's internal confluence wiki.