element/CONTRIBUTING.es.md

Guía para Contribuidores a Element UI

¡Hola! Gracias por elegir Element UI.

Element UI es un archivo de componentes para desarrolladores y para gerentes de productos ‘web’ basado en Vue 2.0

Estamos orgullosos de que usted esta interesado en contribuir al proyecto Element. Antes de someter sus contribuciones, por favor tome un momentito para leer estas simples guías para contribuidores.

Guía Para Reportar Problemas (“Issues”)

• “Issues” son exclusivamente para informar de errores, sugerencias o solicitaciones para funcionalidad adicional referente a diseño. Preguntas de otro tipo corren el riesgo de ser cerradas inmediatamente. Sí tiene preguntas sobre el uso de Element, vea Gitter para más ayuda.

• Antes de someter un informe sobre algún problema, sírvase de revisar sí ya hubo un informe.

• Por favor especifique que versión de Element y Vue que esta utilizando, y que versión de sistema operativo y que versión de navegador web que está utilizando. JSFiddle esta recomendado para crear un entorno para reproducir el problema claramente.

Guías para un “Pull Request (PR)”

• Crea una bifurcación (“fork”) del repositorio a su propia cuenta en github.com. Por favor no crea ramas nuevas aquí.

• Cuando cometa su cambio, formatea en esta forma: [Nombre de componente]: Datos sobre el “commit”. (por ejemplo. Button: Reparación de xxx error)

• DE NINGUNA MANERA incluya archivos dentro del directorio lib.

• Asegúrese de que el comando npm run dist produzca los archivos correctos.

• Para asegurar compatibilidad y reducir tamaño de los archivos, nuestra configuración de babel solo importa preset-2015, así que IPAs como Array.prototype.findyObject.assignenES2015` no son recomendados. Puede importar “polyfills” terceros, sí es necesario.

• “Rebase” antes de crear un “pull request (PR)” para mantener la historia de “commits” limpia.

• Asegúrese que sus PRs se refrieran a la rama dev y no a la rama master.

• Si su PR arregla un error técnico, por favor, haga referencia al error especifico.

• Fusión de un PR requiere dos mantenedores: el primero aprueba los cambios después de revisar, y entonces el segundo mantenedor revisa los cambios y hace la fusión.

Requerimientos Técnicos

Node.js 4+ y NPM 3+ son requisitos .

git clone git@github.com:ElemeFE/element.git
npm run dev

# abra http://localhost:8085

Para usuarios chinos, yarn con taobao registry es recomendado, sí la instalación de dependencias es lenta.

npm i yarn -g
yarn config set registry https://registry.npm.taobao.org
yarn
npm run dev

# abra http://localhost:8085

Para armar:

shell
npm run dist

Guía Para Desarrollo de Componentes

• Corra el comando make new <component-name> para crear el directorio de su proyecto para un componente nuevo. Verifique su código fuente test, configuración para armar, documentación y package.json están incluidos.
• Refiérase al Button para componentes anidados.
• Refiérase al Select para componentes que dependen de otros componentes.

Estilo de Desarrollo

Por favor acate a este estilo ESLint configuración de ElemeFE.