API documentation with executable examples

The rise of component-based software development has created an urgent need for effective application program interface (API) documentation. Experience has shown that it is hard to create precise and readable documentation. Prose documentation can provide a good overview but lacks precision. Formal methods offer precision but the resulting documentation is expensive to develop. Worse, few developers have the skill or inclination to read formal documentation. We present a pragmatic solution to the problem of API documentation. We augment the prose documentation with executable test cases, including expected outputs, and use the prose plus the test cases as the documentation. With appropriate tool support, the test cases are easy to develop and read. Such test cases constitute a completely formal, albeit partial, specification of input/output behavior. Equally important, consistency between code and documentation is demonstrated by running the test cases. This approach provides an attractive bridge between formal and informal documentation. We also present a tool that supports compact and readable test cases; and generation of test drivers and documentation, and illustrate the approach with detailed case studies. (C) 2002 Elsevier Science Inc. All rights reserved.

Relationship between flocculation of activated sludge and composition of extracellular polymeric substances

Activated sludge floes are a flocculated mass of microorganisms, extracellular polymeric substances (EPS) and adsorbed organic and inorganic material. The structure of the floes is very heterogeneous and floes with very different properties and morphologies may occur, depending on the conditions in the activated sludge treatment plant and wastewater composition. Present thinking suggests that cations, such as calcium, create cationic bridges with EPS excreted by the bacteria and thereby hold the various floe constituents together. However, due to the complex and heterogeneous nature of activated sludge, the mechanisms have neither been thoroughly investigated nor successfully quantified. A better understanding and description of the biological flocculation process is necessary in order to establish more efficient operational strategies. The main aim of this study was to get a comprehensive and unique insight into the floe properties of activated sludge and to assess the relative impact of chemical and physical parameters. A variety of sludges from full scale treatment plants with different settling properties were characterised. The interrelationships between floe parameters such as composition of EPS, surface properties and floe structure, and their effect on the flocculation and separation properties were assessed. The results indicate that the EPS, both in terms of quantity and quality, are very important for the floe properties of the activated sludge. However, presence of filaments may alter the physical properties of the floes considerably. The EPS showed positive correlations to sludge volume index (SVI) if only sludges with low or moderate numbers of filaments were included. The surface properties were more affected by the composition of the EPS than by the number of filaments. The EPS showed positive correlation to negative surface charge and a negative correlation to relative hydrophobicity and flocculation ability. The negative correlation between flocculation ability and amount of EPS was surprising. The shear sensitivity, measured as degree of erosion of floes when subjected to shear, was more affected by floe size and number of filaments than amount of EPS.

Matriz de capacita????o modelada por compet??ncias para atuar em programas de educa????o a dist??ncia: uma proposta para as escolas de governo

This study discusses distance learning (DL) as a corporate education strategy in the scope of National Policy on Staff Development. The purpose was to identify, along with managers and specialists of National Network of Schools of Government in Brazil (RNEG), demanded competencies for DL professionals acting in continued education to service public. Part of the research is based in official documents and in related capacity-building initiatives of Schools of Government in the last three years. Through questionnaire sent to managers of institutions of RNEG, we identified existing infrastructure, teams profile, actions developed in DL and training needs. The research allowed to map the critical competencies to work in DL programs and to create a proposal from a Competency-Based Training Matrix for school teams in order to leverage continuing education programs to public servants in three spheres of government. The results revealed the key technological, pedagogical, management and communication skills, as well as the critical activities and content to be included in the training plans. It was found that 88% of institutions have already implemented or are in the process of implementing DL, and the other 12% are deficient in qualified staff to make regulations on hiring personnel or in technology fluency. This corroborates the importance and the contribution of Competency-Based Training Matrix for RNEG

Sa??de materno infantil no Brasil: evolu????o e programas desenvolvidos pelo Minist??rio da Sa??de

Trata-se de uma revis??o de literatura com o objetivo de descrever a evolu????o da aten????o ?? sa??de materno infantil no Brasil desde o Estado Novo at?? os dias atuais. O levantamento de dados foi realizado em livros, sites do Minist??rio da Sa??de, Legisla????es do Di??rio Oficial e artigos das bases de dados Biblioteca Virtual em Sa??de (BVS/Bireme), Medline e Scientific Eletronic Library (Scielo). As pol??ticas p??blicas de sa??de materno infantil foram definidas seguindo desde os princ??pios meramente reprodutivos at?? aqueles mais amplos, voltados para garantir uma melhor condi????o de sa??de e de vida. Nas ??ltimas d??cadas, com o aux??lio do governo e da sociedade, houve uma progress??o no atendimento da sa??de da mulher e da crian??a. No entanto, conclui-se que, apesar da evolu????o observada, o grande desafio ainda se encontra na redu????o da morbimortalidade materna, neonatal e infantil.

Gobernaciones y nueva gesti??n p??blica en Venezuela

A fines de los ???80, el Estado venezolano inici?? una descentralizaci??n pol??tico-territorial produciendo cambios en las gobernaciones, instancias receptoras de competencias en este proceso, las cuales realizan reformas a trav??s de la estrategia selectiva, incorporando algunas de la propuestas de la nueva gesti??n p??blica. Este trabajo explora estas reformas. Se observan: diferencias entre los servicios sociales y los relacionados directamente con la econom??a; privatizaci??n de ??stos; traspaso a la sociedad civil de algunos servicios sociales, creaci??n de entes descentralizados; automatizaci??n de procesos; flexibilizaci??n laboral; iniciativas con lento avance en rendici??n de cuentas por resultados y capacitaci??n para una nueva cultura administrativa. En conclusi??n: la tendencia es a la conformaci??n de una gesti??n p??blica eficiente sobre la base de la reducci??n del aparato estatal, de costos sociales, as?? como de costos y conflictos laborales y escasa incorporaci??n de las propuestas de participaci??n que permiten profundizar la democracia y promover el bienestar social.

Os dois futuros do ato de governar: processos de descentraliza????o e recentraliza????o no ato de governar

As reformas do setor p??blico ajudaram a torn??-lo mais eficiente e eficaz, mas tamb??m geraram v??rios problemas. Tanto as reformas ao estilo do New Public Management quanto da governan??a contribu??ram para os problemas contempor??neos no ato de governar. Tais problemas t??m sido em grande parte pol??ticos, refletindo a tend??ncia de se enfatizar valores administrativos em detrimento dos valores democr??ticos. Os governos come??aram a reagir aos problemas reais e percebidos no setor p??blico desenvolvendo diversos instrumentos de ???meta-governan??a??? que podem ajudar a governar organiza????es p??blicas, mas que envolvem menos comando e controle diretos. Este artigo aborda as fun????es de governan??a contempor??neas na restaura????o da dire????o e coer??ncia nas pol??ticas e, ao mesmo tempo, no apoio ?? autonomia das organiza????es pol??ticas e no envolvimento de redes de pol??ticas no ato de governar.

Reestrutura????o e expans??o do ensino superior p??blico: o programa Reuni na Universidade Federal do Cear?? sob a vis??o dos alunos

Com a institui????o do Programa de Apoio ao Plano de Reestrutura????o e Expans??o das Universidades Federais (Reuni), o governo federal tenta criar condi????es para ampliar o acesso e a perman??ncia dos estudantes na educa????o superior. Nesse contexto, esta pesquisa objetiva investigar a percep????o dos estudantes dos dez centros acad??micos da Universidade Federal do Cear?? (UFC), regularmente matriculados no 2?? semestre de 2008, em rela????o ao Reuni e ?? proposta de ades??o da UFC ao mencionado programa, a partir de uma perspectiva mercadol??gica. Para a determina????o da amostra de entrevistados foi utilizada a f??rmula de Cochran, para popula????es finitas, e amostras aleat??rias estratificadas, resultando em uma amostra de 378 estudantes para um n??vel de confian??a de 95%. Foram utilizadas vari??veis que influenciam o comportamento do p??blico-alvo, tais como renda, grupo social e idade, com foco no marketing educacional. Trata-se de uma pesquisa quantitativa quanto ?? sua natureza, descritiva quanto aos fins e realizada mediante survey. Constatou-se grande desconhecimento sobre o Reuni ??? 50,5% dos entrevistados nunca ouviram falar sobre o programa. Percebeu-se ainda que os estudantes que possuem uma atitude negativa sobre o Reuni aprovam o conte??do da proposta da UFC, da mesma maneira que os estudantes que n??o possuem essa atitude.

A carreira de gestor p??blico e sua forma????o

Apesar de todo investimento nos ??ltimos anos, do poder p??blico, em qualificar profissionais, criar cursos e institui????es para forma????o de gestores p??blicos, o que parece ainda vigorar s??o as indica????es, para os cargos de gestores de unidades de sa??de. A carreira do Gestor P??blico na ??rea de sa??de deve ser feita atrav??s da Escola Nacional de Administra????o P??blica (ENAP), criada para tal fim, nos moldes atuais da carreira de Especialistas em Pol??ticas P??blicas e Gest??o Governamental (EPPGG) ou por outras Escolas como a Escola Nacional de Sa??de P??blica (ENSP). A????es e press??es de atores internacionais interferem na gest??o governamental, levando os governantes a promoverem reformas em suas administra????es visando atender esses interesses. Reformas administrativas ocorreram, em sua maioria, n??o por vontade do governo vigente, mas sim por v??rios fatores, sejam internos ou externos ao pa??s. Devido ao processo de globaliza????o e ao ide??rio neoliberal, que defendiam menor participa????o de interven????o do Estado na economia, reformas administrativas ocorreram e vem ocorrendo. Nos anos recentes, visando responder ??s demandas de novos conhecimentos e tecnologias colocadas pelo sistema de sa??de brasileiro em r??pida transforma????o, foi criado o espa??o institucional na, Escola de Governo em Sa??de (EGS), implantada na ENSP em 1998, dedicada a mobilizar e potencializar os esfor??os institucionais especificamente dirigidos a colaborar com a amplia????o da capacidade de governo em sa??de. Faremos uma breve exposi????o da forma????o de profissionais para a carreira de gest??o p??blica em alguns pa??ses das Am??ricas, mostrando a diversidade dos modelos de Escolas de Governo.

Rediscovery of Melanepyris (Hymenoptera: Bethylidae) : a new synonym of Epyris

Melanepyris Kieffer, 1913 was proposed to accommodate a single species of Epyris Westwood, 1832, E. imicola Kieffer, 1913, mainly based on the absence of the posterior propodeal carina. Today, Melanepyris includes only two nominal species. The type-material of these species has been considered lost since their original description. In this study, the single known adult male (holotype) of Melanepyris asiaticus Kieffer, 1922 from the Philippines has been rediscovered, redescribed and illustrated. Melanepyris asiaticus is transferred to Epyris Westwood due to the following features: scutellar groove absent, well separated scutellar pits and lower mesopleural fovea large and with undefined upper margin. We checked the original description of M. imicola and concluded that it also fits the definition of Epyris perfectly, except for the (described) absence of a posterior carina. However, the thickness of the posterior carina of the propodeal disc varies within species of different Epyrinae genera. The diagnostic characters used by Kieffer to create Melanepyris and other genera from Epyris are briefly discussed. Melanepyris is proposed as a new junior synonym of Epyris, with the transfer of M. imicola to Epyris.

Cartografando estratégias de resistência construídas por educadores no cotidiano de trabalho numa escola de Vitória-ES

Este estudo buscou cartografar as estratégias de resistência construídas por professores de uma escola pública municipal de ensino infantil da cidade de Vitória, considerando a dinamicidade da produção de saúde e doença. A cartografia se efetivou por meio de vivência institucional, entrevistas, construção de um diário de campo, questionários, fotografias e confrontação-validação dos resultados com o coletivo de trabalhadores. Apesar de todas as nocividades do ambiente de trabalho, os professores não se deixam paralisar e criam estratégias, novas formas de fazer seu trabalho, buscando condições menos adoecedoras para o desenvolvimento de suas atividades que, quando coletivizadas, potencializam o processo inventivo desses trabalhadores. Os resultados da pesquisa indicam a importância dessas discussões, uma vez que dão visibilidade a essas formas de luta, o que pode promover transformação do que é vivido nas escolas hoje.

Nos fios de Ariádne : cartografia da relação saúde-trabalho numa escola pública de Vitória-ES

Trata-se de estudo qualitativo abordando as relações entre saúde e trabalho de professores de uma escola da rede pública na cidade de Vitória, capital do estado do Espírito Santo. Seu objetivo foi cartografar as vivências de prazer e sofrimento dos docentes, principalmente as estratégias criadas para defenderem-se das nocividades do ambiente de trabalho e produzirem saúde. Afirma a indissociabilidade entre modos de trabalhar e modos de subjetivar, e constata que a deterioração do sistema público de ensino tem produzido seus efeitos no trabalho do professorado, comprometendo a saúde desses profissionais e gerando, muitas vezes, seu afastamento das funções por meio de licenças médicas ou mesmo abandono da profissão. Procura dar visibilidade às ações que apontam para a recriação do trabalho, mesmo dentro de condições adversas.

Quadros de Ferro? Influências da historiografia na produção de livros didáticos de história regional nos municípios capixabas de Anchieta e Piúma

Espremidas entre o mar e as montanhas, as cidades de Piúma e Anchieta, no litoral sul capixaba, tiveram sua rotina de redes e anzóis alterada com a chegada da Samarco no final da década de 1970 e, posteriormente, do turismo e da exploração do petróleo e do gás. Incomodados, alguns munícipes promoveram atividades que, acreditavam, construiriam uma representação de identidade regional. Entre essas iniciativas está a publicação de livros didáticos abordando a história e a geografia daqueles municípios. Para compreendermos o processo de produção e a narrativa contida nesses livros, nos apoiamos nos conceitos de representação, apropriação e autoria de Chartier (1990, 2002, 2010, 2012) e na análise das relações entre os três sentidos da história – o cotidiano, o escolar e o acadêmico - e do dilema que acompanha a história escolar desde sua origem e que transformou os livros didáticos em documentos de identidade, pensadas por Carretero (2010). O que se encontrou foi uma representação de identidade local que suporta distintas temporalidades, entre elas se destaca o que se chama de influência Varnhagen que produziu uma identidade como resultado da participação das etnias negra e indígena, mas sob predomínio europeu.

O sentido de ser professor de Educação Física pelos “modos de ser sendo junto ao outro no mundo” perverso- fascista e democrático: a vivência real & no filme “Má Educação”

Quais são os “modos de ser sendo junto ao outro no mundo” professores de Educação Física da Prefeitura Municipal da Serra, ES, situados no que se denomina “real” e do professor de Educação Física padre José no filme “Má Educação” de Pedro Almodóvar situado no que se denomina “ficcional”? Que contribuições reflexivas podem trazer tais dados (analisados hermeneuticamente) para a Formação Continuada de professores de Educação Física [3]? OBJETIVO: Descrever os “modos de ser sendo junto ao outro no mundo” de [1] professores de Educação Física que trabalham em escolas públicas da Prefeitura Municipal da Serra, ES & do [2] padre José, personagem ficcional, professor de Educação Física no filme espanhol de 2004 “Má Educação” fazendo-o primeiramente através de uma pesquisa clássica (descritiva e hermenêutica) e depois uma literaturalizada e artística (hermenêutica). MARCO TEÓRICO: Trata-se de uma proposta discursiva (teórica) fenomenológica existencial de tendência marxista criada por Pinel; METODOLOGIA: Tratou-se de uma pesquisa fenomenológica existencial seguindo recomendações de Forghieri (2001) e Pinel (2006; 2012) - dentre outros. Os 29 professores de Educação Física foram provocados a mostrarem os seus “modos de ser sendo junto ao outro no mundo” do ofício professor de Educação Física. Depois essa mesma provocação foi feita ao personagem do filme. RESULTADOS & DISCUSSÃO: Descreveram-se [1] os “modos de ser sendo junto ao outro no mundo” dos professores de Educação Física na dimensão do real e do ficcional (cinema), e não se objetivou comparação por mais que isso tenha ficado evidente. Esses professores, em 2011/2012, experienciando uma democracia (im)perfeita brasileira [que tem até tendências neofascistas], mais ainda assim democracia - foram compreendidos sempre tomando um norte/ rumo/ direção em subjetivação pelos Guias de Sentido (GS – Pinel) democráticos reconhecimento [demanda do grupo em ser valorizado, reconhecido], em (im) potência [impotência e potencia possível de vir a lume sempre; a força e seu outro lado, a fragilidade de ser], afetando [o que se pratica e pensa/sente afeta a si mesmo, o outro e o mundo; o afetar produz mais subjetivações], sonhando [há demanda sempre de realizar projetos de vida; o projeto de ser sempre devir, em construção sempre; é uma precisão imprecisa], saudavelmente insano [o quão perto pode estar a experienciar a sanidade e a loucura e o quanto uma loucura é sã, pois criativa, inventiva, produtiva, opositora ao estabelecido] – eles mesmos junto ao outro no mundo tornando-se sujeitos. [2] Já o professor de Educação Física padre José da película almodovariana é um professor que de imediato pode ser apreendido como sólido e fixo na sua perversão fascista, ele como parte legitimadora do Estado espanhol de Franco, na década de 60, provavelmente em 1964, que é, na ficção, o espaço-tempo de José e suas ações pedagógicas e psicológicas (e de Educação Física). Mas não é apenas o fascismo que torna o fascista um criador de um cotidiano fascista, pois afinal, paralelamente a ele, no concreto e na ficção, haviam pessoas generosas, resistentes e resilientes que atuavam contra essas pressões quase na maioria das vezes advindas do todo (Estado) – eram pessoas democráticas individualmente e em pequenos e grandes grupos; eram exemplo de resistência contra o estabelecido pela ideologia dominante de então. José numa instituição fascista não conseguiu refletir e agir diferentemente, isto é, com mais saúde mental, escolhendo (na liberdade) ser fascista, ser menor (pouco) – optou não ser-mais. Finalmente os mesmos dados são apresentados em outra estética possível e sempre aberta, inconclusa, devir... As artes e a poesia (bem como a literatura) procuram cuidadosamente desvelar os “modos de ser junto ao outro no mundo” professor de Educação Física do mundo real e do imaginário (fílmico) desvelando muitas vezes indissociados. PÓSCRITO: O autor descreve as possíveis implicações do seu estudo para educação física pautado sempre em uma proposta de criar um discursso insubmisso focando na ideia de que uma pesquisa demanda narrar a vida, e literaturalizar a ciência.

Pensando o currículo com as crianças: ou sobre aprendizagens inventivas na educação infantil

Ninguém consegue sair ileso de um encontro com o currículo e com a escola, principalmente diante de relações tão assimétricas de poder que não valorizam o que as crianças têm a dizer. Quantas narrativas curriculares sobre as crianças? Quantas narrativas curriculares com as crianças? As narrativas e as fotografias se seguirão nesta pesquisa, porque com elas nos colocamos a pensar nos processos de criação curricular, explorando novas sensibilidades, novas maneiras de ver e falar, a partir das redes de sentidos, forjadas nos contextos vividos, imaginados ou pensados, dentrofora da escola. Também incluímos a forma como as crianças se relacionam com as práticas pedagógicas dos professores e do modo como se relacionam com a escola. Nessa perspectiva, interessa-nos pensar em como os usos (CERTEAU, 1994) da imagem fotográfica são capazes de afetar (e até transformar) as práticas curriculares, traçando algo da potência da/na imagem fotográfica em sua função fabuladora por meio das oficinas de fotografias realizadas com as crianças em virtude da pesquisa. A fotografia se torna potente como um recurso para provocar a invenção tessitura de outros sentidos em currículo não porque em sua materialidade ela está repleta de sentidos de currículo à priori, mas porque pode ou não, ao ser usada (CERTEAU, 1994), ao ser vista pelas crianças, agenciar outros possíveis para o currículo. Assim, o foco da discussão não é a fotografia em si nem a criança em si, ou seja, não há protagonismo nem da criança nem da fotografia. O foco está nas relações, naquilo que nos passa, isto é, na experiência estética (LARROSA, 2004b) que ocorre ao entrarmos em contato, ao vermos, ao compormos com as fotografias! Nesse sentido, pensamos as oficinas de fotografias como um dispositivo de criação e produção de acontecimentos em currículo, considerando-as máquinas de fazer “ver e falar”, o que as justifica como uma estratégia narrativa capaz de produzir acontecimentos na imagem e no mundo. Que sentidos de currículo são produzidos em multiplicidades? Pelas minoridades pretendemos movimentar nosso pensamento: que quer pensar um currículo como fabulação sem dizer o que ele é, mas no que ele vai se transformando com a chegada das crianças. No encontro das imagens com as palavras, em que o currículo vai se transformando? Sob a mesma superfície chamada currículo em extensão com as crianças, co-habitantes, encontrar os modos de olhar esse currículo e de dizê-lo por meio das fotografias, das narrativas, dos cartazes, dos desenhos, das poesias... As conversas com as crianças provocam o real, colocam em desequilíbrio algumas ideias feitas em educação, exigindo reordenações e invenções de outros pensamentos para a educação. É dessa criação de efeitos impensáveis que surge a invenção de currículos possíveis. Aprender a olhar mais (até cansar!) aquilo que não percebemos no dia a dia tem uma dimensão política muito importante; por meio desse gesto (que aprendemos com as crianças) podemos criar um novo pensamento político em educação. A partir daquilo que nos dá a ver, as crianças vão inaugurar sentidos impertinentes, desestabilizadores daquilo que chamamos de currículo e escola. O desafio consiste em falar da força contida na imagem fotográfica sem vontade de interpretá-la ou descrevê-la, mas escrever e pensar pelas fotografias num movimento de criação de sentidos e acontecer por elas.

Avaliação da qualidade dos serviços prestados pela Biblioteca Central da UFES utilizando o método Servqual

O presente trabalho objetiva avaliar a qualidade dos serviços prestados pela Biblioteca Central (BC) da Universidade Federal do Espírito Santo (UFES) utilizando o método Servqual. Esta pesquisa é um estudo de caso de natureza quantitativa e qualitativa. A triangulação dos dados foi realizada por meio de uma survey com 363 usuários, entrevista com nove servidores que atuam na Biblioteca e consulta a documentos da universidade que descrevem as características básicas da Biblioteca Central. A survey foi aplicada utilizando-se questionário desenvolvido com base na escala Servqual em pré-teste realizado na Biblioteca Setorial Tecnológica (BST) da UFES. Foram utilizadas duas modalidades de coleta na survey aplicada na BC: presencial e online. Foram coletados 110 questionários presenciais e 253 online. As entrevistas com os servidores da BC foram baseadas nos 116 registros de reivindicações dos usuários, coletados pela BC anteriormente à pesquisa. Além desses documentos, consultaramse informações institucionais divulgadas no catálogo de serviços da BC e em páginas da BC e da UFES na internet. Identificaram-se quatro dimensões da qualidade dos serviços prestados pela BC, com médias negativas, indicando necessidade de melhoria nos serviços prestados. As ações prioritárias recomendadas para a BC são: a) melhorar instalações físicas e equipamentos; e b) capacitar e motivar os trabalhadores para atendimento aos usuários. Essas ações devem conduzir a soluções de problemas relacionados a condições de estudo (iluminação, climatização, água, banheiros, espaço físico, móveis e silêncio) e acesso a informação (internet, autoempréstimo, quantitativo de exemplares, limitação do empréstimo e alerta quanto à data de renovação).