The discussion has two aspects: (1) delimiter, and (2) name for the main repo.

I studied all the feedback from this thread and found that there were
5 suggested delimiter styles:

* hyphen (e.g., nuttx-apps)
* underscore (e.g., nuttx_apps)
* subdirectory (e.g., nuttx/rtos, nuttx/apps)
* none (e.g., nuttxapps)
* CamelCase (e.g., NuttXApps)

and four suggested names for the main repo (shown without delimiters):

* nuttx
* nuttx rtos
* nuttx core
* nuttx kernel

I made a list of all permutations of all suggested delimiters and names:

[1] nuttx, nuttx-apps
[2] nuttx, nuttx_apps
[3] nuttx, nuttx/apps
[4] nuttx, nuttxapps
[5] NuttX, NuttXApps
[6] nuttx-rtos, nuttx-apps
[7] nuttx_rtos, nuttx_apps
[8] nuttx/rtos, nuttx/apps
[9] nuttxrtos, nuttxapps
[10] NuttXRTOS, NuttXApps
[11] nuttx-core, nuttx-apps
[12] nuttx_core, nuttx_apps
[13] nuttx/core, nuttx/apps
[14] nuttxcore, nuttxapps
[15] NuttXCore, NuttXApps
[16] nuttx-kernel, nuttx-apps
[17] nuttx_kernel, nuttx_apps
[18] nuttx/kernel, nuttx/apps
[19] nuttxkernel, nuttxapps
[20] NuttXKernel, NuttXApps

I suggest to call a [VOTE] thread with all of the above and see which one wins.

Note: If we find that the winning option cannot be done (e.g., suppose
'nuttx/rtos' wins and we find out we can't do directories, or
'NuttXKernel' wins but we find out we can't do capital letters) then
we'll need to have another vote without those options.

Below I will make a summary of all the arguments that I saw:

# Delimeter

The following delimiters showed up in this mail thread:
* hyphen (e.g., nuttx-apps)
* underscore (e.g., nuttx_apps)
* subdirectory (e.g., nuttx/rtos, nuttx/apps)
* none (e.g., nuttxapps)
* CamelCase (e.g., NuttXApps)

The following arguments were presented:

Arguments regarding hyphen '-':
* Pro: Are recommended for URLs by Google [1]
* Pro: Other Apache projects use hyphens (e.g., mynewt-core) [2]
* Con: Some toolchains or filesystems have problems [3] (workaround
exists: git clone [4])
* Con: Filenames should not begin with hyphen because of command line
interpretation

Arguments regarding underscores:
* Pro: Workaround for toolchains or filesystems that don't like hyphens
* Con: Hard to see when underlined link, doesn't work in AWS S3 [5]

Arguments regarding a subdirectory:
* Pro: Gives us our own namespace to use old repo names 'nuttx' and 'apps'
* Con: We don't know if we can do that. We have to ask Infra.

No arguments were presented regarding none or CamelCase, but some
names were suggested with these styles.

References:
[1] https://lists.apache.org/thread/h0418pyxsvk85qfvogdrny3zp2qnzz8m
[2] https://lists.apache.org/thread/54vbjnwoqzod81yg882rkwst4kg7trno
[3] https://lists.apache.org/thread/boo25hsh3b9416tlcvk3n3m1jcv4nph0
[4] https://lists.apache.org/thread/hp88vysm493gh8l5l2l78qynx9jyobtq
[5] https://lists.apache.org/thread/90dh04mpkkcj0j4bqbfjrxos2dv1k2hx

# Repository Names

To avoid showing 5 duplicates with different delimiters, I'll show the
different possibilities with a space. Feel free to imagine that the
space is your favorite delimiter. :-)

Regarding the main repo, the suggestions were (with some choice of delimiter):

* nuttx
* nuttx rtos
* nuttx core
* nuttx kernel

Regarding the apps repo, all suggestions were (with some choice of delimiter):

* nuttx apps

(Note: We cannot use just 'apps' because we have to coexist with other
Apache projects in the same namespace -- unless we can have our own
directory, but we don't know if we can do that.)

The following arguments were presented:

nuttx rtos:
* Pro: Makes it clear to those who don't know that NuttX is a RTOS [6]
* Con: NuttX is more than a traditional RTOS, nuttx is semantically cleaner [7]

nuttx core:
* Pro: Many projects use 'core' (e.g., mynewt-core) [8]
* Con: Looks like library or core dump [9]

nuttx kernel:
* Con: Confusion. NuttX is not a kernel in all build modes [10]

References:
[6] https://lists.apache.org/thread/dbxygkvx2gd208vtoytzn9ojo0r8w7ll
[7] https://lists.apache.org/thread/kjydczss1dgmrxms9y1ryv56clhoj2hm
[8] https://lists.apache.org/thread/54vbjnwoqzod81yg882rkwst4kg7trno
[9] https://lists.apache.org/thread/0lzwjh2s2tyj4b56cj7gds1lok74236j
[10] https://lists.apache.org/thread/3v0m12kl0wtpfn7rk0ykl3cj9vn5h0qw

Are we ready to call a [VOTE] thread or does anyone have more
input/arguments/suggestions?

Thanks,
Nathan

Reply via email to