**Public properties** are formally a part of the Public API.
Public properties are **stable properties**: they CANNOT be renamed or removed without notice.
While we normally deprecate the feature or behavior itself, changes to the property cannot happen in a minor release.
Public properties must be documented.

**Internal properties** are not part of the Public API.
Internal properties are **unstable properties**: they CAN be renamed or removed without notice.

        val subprojectRoots = File("../platforms").listFiles(File::isDirectory).plus(File("../subprojects"))
        val subProjectFolders =
            subprojectRoots.map { it.listFiles(File::isDirectory).asList() }.flatten().filter { dir ->
                // filter out the directories that have only a `build` subdirectory - this usually happens after branch switching

      <item index="5" class="java.lang.String" itemvalue="org.gradle.internal.scan.UsedByScanPlugin" />
      <item index="6" class="java.lang.String" itemvalue="org.gradle.internal.service.Provides" />
    </list>
    <pattern value="org.gradle.internal.service.ServiceRegistrationProvider" hierarchically="true" method="configure" />
  </component>
  <component name="ExternalStorageConfigurationManager" enabled="true" />

* Some public APIs have incorrect nullability annotations (both overly restrictive and overly permissive)

While there are competing ways to represent absence (`Optional`, "Null Object" pattern, method overloads),
it is unlikely that we'll be able to remove `null` entirely.

After migrating to Java 8, we can use pluggable type checkers to ensure that our annotations are consistent, 
and there are no missing null checks.

| GSA Setting | Fess Equivalent |
|-------------|----------------|
| Collection | WebConfig or FileConfig |
| Start URLs | URLs field in crawl config |
| Good URL Pattern | Included URLs (regex) |
| Bad URL Pattern | Excluded URLs (regex) |
| Follow/Index Pattern | Config Depth and Filter settings |

**Implementation Details**

        StopwordsItem item4 = new StopwordsItem(1, "different");

        // Same object
        assertTrue(item1.equals(item1));

        // Same input value (id doesn't matter)
        assertTrue(item1.equals(item2));
        assertTrue(item1.equals(item3));

        // Different input value
        assertFalse(item1.equals(item4));

        // Null and different class

@EnabledIfEnvironmentVariable(named = "CI", matches = ".*", disabledReason = "Tests rely on setup conditional on CI in gradlebuild.ci-reporting plugin running first, these test should only run if CI env var is present (it's value doesn't matter)")
class TestFilesCleanupServiceTest {
    @TempDir
    lateinit var projectDir: File

    @TempDir
    lateinit var testKitDir: File

    private
    fun File.mkdirsAndWriteText(text: String) {

        // Verify direct field access
        assertEquals(999L, item.id);
    }

    @Test
    public void test_sequentialIdAssignment() {
        // Test sequential ID assignment pattern
        TestDictionaryItem[] items = new TestDictionaryItem[5];

        for (int i = 0; i < items.length; i++) {
            items[i] = new TestDictionaryItem();
            items[i].id = i + 1;
        }

            Files.deleteIfExists(tempFile);
        }
    }

    @Test
    public void test_constructor_isProtected() {
        // Verify that ThreadDumpUtil has a protected constructor (utility class pattern)
        try {
            Constructor<ThreadDumpUtil> constructor = ThreadDumpUtil.class.getDeclaredConstructor();

            processor.setSearcher(new TestSearcher(100));
            processor.register(new NumericIdFieldSearcher());
            processor.init();

            // Should skip documents with non-string ID (pattern matching fails)
            final List<Map<String, Object>> results = processor.search("*", new TestSearchRequestParams(0, 10, 0), OptionalThing.empty());
            assertNotNull(results);
        }
    }

    /**